The orientation
CSS descriptor controls the orientation of a document defined by @viewport
.
/* Keyword values */ orientation: auto; orientation: portrait; orientation: landscape;
For a UA/device where the orientation is changed upon tilting the device, an author can use this descriptor to inhibit the orientation change.
Syntax
Values
auto
- The user agent will set the document's orientation automatically, typically based on the device's orientation as determined by an accelerometer (if the device has such a hardware sensor), although there is often a user-controlled, OS-level "Lock orientation" setting that will trump the accelerometer reading.
portrait
- The document should be locked into portrait orientation.
landscape
- The document should be locked into landscape orientation.
Formal definition
Related at-rule | @viewport |
---|---|
Initial value | auto |
Percentages | refer to the size of bounding box |
Computed value | as specified |
Formal syntax
auto | portrait | landscape
Examples
Setting viewport orientation
@viewport { orientation: landscape; }
Specifications
Specification | Status | Comment |
---|---|---|
CSS Device Adaptation The definition of '"orientation" descriptor' 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.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
orientation descriptor | Chrome No support No | Edge
No support
12 — 79
| Firefox No support No | IE
Full support
10
| Opera No support No | Safari No support No | WebView Android No support No | Chrome Android No support No | Firefox Android No support No | Opera Android
No support
11.1 — 14
| Safari iOS No support No | Samsung Internet Android No support No |
Legend
- Full support
- Full support
- No support
- No support
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.