ScreenOrientation

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The ScreenOrientation interface of the the Screen Orientation API provides information about the current orientation of the document.

Properties

ScreenOrientation.type Read only
Returns the document's current orientation type, one of "portrait-primary", "portrait-secondary", "landscape-primary", or "landscape-secondary".
ScreenOrientation.angle Read only
Returns the document's current orientation angle.

Event handlers

ScreenOrientation.onchange
Fired whenever is the EventHandler called when the screen changes orientation.

Methods

ScreenOrientation.lock()
Locks the orientation of the containing document to its default orientation and returns a Promise
ScreenOrientation.unlock()
Unlocks the orientation of the containing document from its default orientation.

Specifications

Specification Status Comment
Screen Orientation API
The definition of 'ScreenOrientation' in that specification.
Working Draft Initial definition.

Browser Compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome Full support 38Edge No support NoFirefox Full support 43IE No support NoOpera Full support 25Safari No support NoWebView Android Full support 38Chrome Android Full support 38Edge Mobile No support NoFirefox Android Full support 43Opera Android Full support 25Safari iOS No support NoSamsung Internet Android Full support 5.0
angleChrome Full support 38Edge No support NoFirefox Full support 43IE No support NoOpera Full support 25Safari No support NoWebView Android Full support 38Chrome Android Full support 38Edge Mobile No support NoFirefox Android Full support 43Opera Android Full support 25Safari iOS No support NoSamsung Internet Android ?
onchangeChrome Full support 38Edge No support NoFirefox Full support 43IE No support NoOpera Full support 25Safari No support NoWebView Android Full support 38Chrome Android Full support 38Edge Mobile No support NoFirefox Android Full support 43Opera Android Full support 25Safari iOS No support NoSamsung Internet Android ?
typeChrome Full support 38Edge No support NoFirefox Full support 43IE No support NoOpera Full support 25Safari No support NoWebView Android Full support 38Chrome Android Full support 38Edge Mobile No support NoFirefox Android Full support 43Opera Android Full support 25Safari iOS No support NoSamsung Internet Android ?
lockChrome Full support 38Edge No support NoFirefox Full support 43IE No support NoOpera Full support 25Safari No support NoWebView Android Full support 38Chrome Android Full support 38Edge Mobile No support NoFirefox Android Full support 43Opera Android Full support 25Safari iOS No support NoSamsung Internet Android ?
unlockChrome Full support 38Edge No support NoFirefox Full support 43IE No support NoOpera Full support 25Safari No support NoWebView Android Full support 38Chrome Android Full support 38Edge Mobile No support NoFirefox Android Full support 43Opera Android Full support 25Safari iOS No support NoSamsung Internet Android ?

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown

Document Tags and Contributors

Contributors to this page: brdjns, fscholz, jpmedley
Last updated by: brdjns,