This is an experimental technology
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future versions of browsers as the specification changes.
The Screen.orientation
property give the current orientation of the screen.
Syntax
var orientation = window.screen.orientation.type;
Return value
The return value is a string representing the orientation of the screen. It can be portrait-primary
, portrait-secondary
, landscape-primary
, landscape-secondary
(See lockOrientation
for more info about those values).
Example
var orientation = screen.orientation || screen.mozOrientation || screen.msOrientation; if (orientation.type === "landscape-primary") { console.log("That looks good."); } else if (orientation.type === "landscape-secondary") { console.log("Mmmh... the screen is upside down!"); } else if (orientation.type === "portrait-secondary" || orientation.type === "portrait-primary") { console.log("Mmmh... you should rotate your device to landscape"); }
Specifications
Specification | Status | Comment |
---|---|---|
Screen Orientation API The definition of 'Screen Orientation' in that specification. |
Working Draft | Initial definition |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 38 | (Yes) moz[1] | 11ms[2] | 25 | No support |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | 39 | (Yes) moz[1] | No support | No support | No support |
[1] This API is only implemented as a prefixed method (mozOrientation
) in B2G and Firefox for Android.
[2] This API is implemented using a prefix (msOrientation
) in Internet Explorer for Windows 8.1 and Windows RT 8.1. It is not supported on Windows 7.