Non-standard
This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.
The -webkit-device-pixel-ratio
is a non-standard Boolean CSS media feature which is an alternative to the standard resolution
media feature.
Note: This media feature is a WebKit feature. If possible, use the resolution
media feature query instead.
Syntax
The -webkit-device-pixel-ratio
feature is specified as a <number>
value. It is a range feature, meaning that you can also use the prefixed -webkit-min-device-pixel-ratio
and -webkit-max-device-pixel-ratio
variants to query minimum and maximum values, respectively.
Values
<number>
- The number of device pixels used to represent each CSS
px
. Although the value is a<number>
, and thus doesn't syntactically allow units, its implicit unit isdppx
.
Implementation
/* A unit of "dppx" is implied: */ @media (-webkit-min-device-pixel-ratio: 2) { ... } /* ... is equivalent to: */ @media (min-resolution: 2dppx) { ... } /* Similarly: */ @media (-webkit-max-device-pixel-ratio: 2) { ... } /* ... is equivalent to: */ @media (max-resolution: 2dppx) { ... }
Examples
HTML
<p>This is a test of your device's pixel density.</p>
CSS
/* Exact resolution */ @media (-webkit-device-pixel-ratio: 1) { p { color: red; } } /* Minimum resolution */ @media (-webkit-min-device-pixel-ratio: 1.1) { p { font-size: 1.5em; } } /* Maximum resolution */ @media (-webkit-max-device-pixel-ratio: 3) { p { background: yellow; } }
Result
Specifications
Specification | Status | Comment |
---|---|---|
Compatibility Standard The definition of '-webkit-device-pixel-ratio' in that specification. |
Living Standard | Initial standardization |
Safari CSS Reference 'media query extensions' in that document. |
Non-standard unofficial documentation | Initial documentation |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
-webkit-device-pixel-ratio media feature | Chrome Full support 1 | Edge Full support 12 | Firefox
Full support
63
| IE No support No | Opera Full support 15 | Safari Full support 3 | WebView Android Full support ≤37 | Chrome Android Full support 18 | Firefox Android
Full support
63
| Opera Android Full support 14 | Safari iOS Full support 1 | Samsung Internet Android Full support 1.0 |
Legend
- Full support
- Full support
- No support
- No support
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
- See implementation notes.
- See implementation notes.
- User must explicitly enable this feature.
- User must explicitly enable this feature.