What is the prefers-color-scheme media feature for dark mode?
Jul 14, 2025 am 01:55 AMprefers-color-scheme is a CSS media query function that detects whether the user's operating system has dark or light colors set. ① It allows websites to apply different styles according to the user's system preferences without forcing dark mode to be enabled; ② When using it, it must wrap dark styles through @media (prefers-color-scheme: dark) in the style sheet; ③ Define the default style as a fallback scheme; ④ You can combine localStorage to enable users to manually switch themes; ⑤ Modern browsers generally support it, but only rely on system settings and do not respond to ambient light or time changes.
Dark mode has become a common feature across websites and apps, and the prefers-color-scheme
media feature is what allows websites to detect whether a user has set their operating system to dark or light mode.
What does prefers-color-scheme
do?
This CSS media query lets you apply different styles based on the user's system preference. It doesn't force dark mode — it just gives you a way to respect what the user already choose in their OS settings.
So if someone has their phone or computer set to dark mode, your site can automatically switch to a darker theme without them needing to click a toggle.
How to use prefers-color-scheme in CSS
You can use this media query directly in your stylesheets. The basic idea is to wrap your dark mode styles inside a condition that checks for prefers-color-scheme: dark
.
Here's how it looks:
@media (prefers-color-scheme: dark) { body { background-color: #121212; color: #e6e6e6; } }
If the user prefers dark mode, those styles will take effect. Otherwise, your default (light mode) styles show up.
A few tips:
- You can also check for
prefers-color-scheme: light
, but most of the time, you'll only need to handle the dark case. - Don't forget to define fallback styles outside the media query — not everyone uses a system-level preference.
- Combine it with CSS variables for easier theme management.
Combining with custom themes
Sometimes users might want to override the system setting and choose a theme manually on your site. In that case, prefers-color-scheme
isn't enough by itself.
You'd need to:
- Add a toggle button that saves the user's choice (eg, using localStorage)
- Apply the selected theme regardless of the system preference
This way, even if the system says "dark", the user can still pick light mode — which is helpful for people who prefer a different style than their OS setting.
Browser support and limitations
Good news: prefers-color-scheme
is supported in all modern browsers — Chrome, Firefox, Safari, Edge, and mobile browsers.
But keep in mind:
- It only works if the user has set a system-wide preference
- It doesn't adapt to ambient light or time of day — just follow OS settings
- Old browsers may ignore it, so always test your fallbacks
Using prefers-color-scheme
is a clean and user-friendly way to offer dark mode without forcing choices on visitors. Pair it with manual controls if needed, and you've got a solid setup.
Basically that's it.
The above is the detailed content of What is the prefers-color-scheme media feature for dark mode?. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

There are three ways to create a CSS loading rotator: 1. Use the basic rotator of borders to achieve simple animation through HTML and CSS; 2. Use a custom rotator of multiple points to achieve the jump effect through different delay times; 3. Add a rotator in the button and switch classes through JavaScript to display the loading status. Each approach emphasizes the importance of design details such as color, size, accessibility and performance optimization to enhance the user experience.

To deal with CSS browser compatibility and prefix issues, you need to understand the differences in browser support and use vendor prefixes reasonably. 1. Understand common problems such as Flexbox and Grid support, position:sticky invalid, and animation performance is different; 2. Check CanIuse confirmation feature support status; 3. Correctly use -webkit-, -moz-, -ms-, -o- and other manufacturer prefixes; 4. It is recommended to use Autoprefixer to automatically add prefixes; 5. Install PostCSS and configure browserslist to specify the target browser; 6. Automatically handle compatibility during construction; 7. Modernizr detection features can be used for old projects; 8. No need to pursue consistency of all browsers,

Themaindifferencesbetweendisplay:inline,block,andinline-blockinHTML/CSSarelayoutbehavior,spaceusage,andstylingcontrol.1.Inlineelementsflowwithtext,don’tstartonnewlines,ignorewidth/height,andonlyapplyhorizontalpadding/margins—idealforinlinetextstyling

Setting the style of links you have visited can improve the user experience, especially in content-intensive websites to help users navigate better. 1. Use CSS's: visited pseudo-class to define the style of the visited link, such as color changes; 2. Note that the browser only allows modification of some attributes due to privacy restrictions; 3. The color selection should be coordinated with the overall style to avoid abruptness; 4. The mobile terminal may not display this effect, and it is recommended to combine it with other visual prompts such as icon auxiliary logos.

Use the clip-path attribute of CSS to crop elements into custom shapes, such as triangles, circular notches, polygons, etc., without relying on pictures or SVGs. Its advantages include: 1. Supports a variety of basic shapes such as circle, ellipse, polygon, etc.; 2. Responsive adjustment and adaptable to mobile terminals; 3. Easy to animation, and can be combined with hover or JavaScript to achieve dynamic effects; 4. It does not affect the layout flow, and only crops the display area. Common usages are such as circular clip-path:circle (50pxatcenter) and triangle clip-path:polygon (50%0%, 100 0%, 0 0%). Notice

To create responsive images using CSS, it can be mainly achieved through the following methods: 1. Use max-width:100% and height:auto to allow the image to adapt to the container width while maintaining the proportion; 2. Use HTML's srcset and sizes attributes to intelligently load the image sources adapted to different screens; 3. Use object-fit and object-position to control image cropping and focus display. Together, these methods ensure that the images are presented clearly and beautifully on different devices.

Different browsers have differences in CSS parsing, resulting in inconsistent display effects, mainly including the default style difference, box model calculation method, Flexbox and Grid layout support level, and inconsistent behavior of certain CSS attributes. 1. The default style processing is inconsistent. The solution is to use CSSReset or Normalize.css to unify the initial style; 2. The box model calculation method of the old version of IE is different. It is recommended to use box-sizing:border-box in a unified manner; 3. Flexbox and Grid perform differently in edge cases or in old versions. More tests and use Autoprefixer; 4. Some CSS attribute behaviors are inconsistent. CanIuse must be consulted and downgraded.

The choice of CSS units depends on design requirements and responsive requirements. 1.px is used for fixed size, suitable for precise control but lack of elasticity; 2.em is a relative unit, which is easily caused by the influence of the parent element, while rem is more stable based on the root element and is suitable for global scaling; 3.vw/vh is based on the viewport size, suitable for responsive design, but attention should be paid to the performance under extreme screens; 4. When choosing, it should be determined based on whether responsive adjustments, element hierarchy relationships and viewport dependence. Reasonable use can improve layout flexibility and maintenance.
