The light-level CSS media feature can be used to test the ambient light level.
Syntax
dim- The device is used in a dim environment, where excessive contrast and brightness would be distracting or uncomfortable to the reader. For example: night time, or a dimly illuminated indoor environment.
normal- The device is used in a environment with a light level in the ideal range for the screen, and which does not necessitate any particular adjustment.
washed- The device is used in an exceptionally bright environment, causing the screen to be washed out and difficult to read. For example: bright daylight.
Examples
This code will likely not work on any devices (device compatibility is low).
@media (light-level: normal) {
p {
background: url("texture.jpg");
color: #333;
}
}
@media (light-level: dim) {
p {
background: #222;
color: #ccc;
}
}
@media (light-level: washed) {
p {
background: white;
color: black;
font-size: 2em;
}
}
Specifications
| Specification | Status | Comment |
|---|---|---|
| Media Queries Level 5 The definition of 'light-level' in that specification. |
Editor's 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 | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
light-level media feature | Chrome No support No | Edge No support No | Firefox No support No | IE No support No | 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 No | Safari iOS No support No | Samsung Internet Android No support No |
Legend
- No support
- No support
