W3cubDocs

/DOM

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 CompatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
Basic support 38 No 43 No 25 No
angle 38 No 43 No 25 No
onchange 38 No 43 No 25 No
type 38 No 43 No 25 No
lock 38 No 43 No 25 No
unlock 38 No 43 No 25 No
Mobile
Android webview Chrome for Android Edge Mobile Firefox for Android Opera for Android iOS Safari Samsung Internet
Basic support 38 38 No 43 25 No 5.0
angle 38 38 No 43 25 No ?
onchange 38 38 No 43 25 No ?
type 38 38 No 43 25 No ?
lock 38 38 No 43 25 No ?
unlock 38 38 No 43 25 No ?

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/screenOrientation