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.typeRead only- Returns the document's current orientation type, one of "portrait-primary", "portrait-secondary", "landscape-primary", or "landscape-secondary".
ScreenOrientation.angleRead only- Returns the document's current orientation angle.
Event handlers
ScreenOrientation.onchange- The
EventHandlercalled whenever 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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
| Desktop | Mobile | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ScreenOrientation | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support 5.0 |
angle | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support Yes |
onchange | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support Yes |
type | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support Yes |
lock | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support Yes |
unlock | Chrome Full support 38 | Edge No support No | Firefox Full support 43 | IE No support No | Opera Full support 25 | Safari No support No | WebView Android Full support 38 | Chrome Android Full support 38 | Edge Mobile No support No | Firefox Android Full support 43 | Opera Android Full support 25 | Safari iOS No support No | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- No support
- No support