ScreenOrientation
Experimental
This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The ScreenOrientation
interface of the Screen Orientation API provides information about the current orientation of the document.
A ScreenOrientation
instance object can be retrieved using the window.screen.orientation
property.
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
- The
EventHandler
called 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
BCD tables only load in the browser