css-prefers-color-scheme

December 15, 2023

• Fix type definitions

July 3, 2023

• Change license to MIT-0 (read more about this change in the blog post)

February 6, 2023

• Reduce the amount of duplicate fallback CSS.

January 28, 2023

• Improve types declaration in package.json

January 24, 2023

• Updated: Support for Node v14+ (major).

August 23, 2022

• Fix: assign global browser polyfill to window, self or a blank object.

July 8, 2022

Read the full changelog

• Breaking: removed old CDN urls
• Breaking: remove color-depth queries fallback
• Breaking: remove 'no-preference' support as this was dropped from the spec
• Breaking: remove old global object
• Fix: case insensitive matching.

How to migrate :

Re-build your CSS with the new version of the library.

If you use a CDN url, please update it.

- <script src="https://unpkg.com/css-prefers-color-scheme/browser"></script>
+ <script src="https://unpkg.com/css-prefers-color-scheme/dist/browser-global.js"></script>

- <script src="https://unpkg.com/css-prefers-color-scheme/browser.min"></script>
+ <script src="https://unpkg.com/css-prefers-color-scheme/dist/browser-global.js"></script>

Use prefersColorSchemeInit to initialize the polyfill in the browser.

- initPrefersColorScheme()
+ prefersColorSchemeInit()

Remove @media (prefer-color-scheme: no-preference) from your CSS.

@media (prefers-color-scheme: no-preference) was removed from the specification and should be equivalent to not having any media query.

- @media (prefers-color-scheme: no-preference) {
- 	.some-selector {
- 		/* your styles ... */
- 	}
- }
+ .some-selector {
+ 	/* your styles ... */
+ }

January 31, 2022

• Fix preserve: false option.

January 2, 2022

• Removed Sourcemaps from package tarball.
• Moved CLI to CLI Package. See announcement.

December 27, 2021

• Fixed: require/import paths for browser script

December 13, 2021

• Breaking: require/import paths have changed
• Changed: new polyfill CDN urls.
• Updated: documentation
• Fixed: CSSRuleList edits skipping rules as this is a live list.
• Fixed: complex @media queries not working.

Migrating to 6.0.0

PostCSS plugin :

- const postcssPrefersColorScheme = require('css-prefers-color-scheme/postcss');
+ const postcssPrefersColorScheme = require('css-prefers-color-scheme');

Browser Polyfill :

- const prefersColorScheme = require('css-prefers-color-scheme')();
+ const prefersColorScheme = require('css-prefers-color-scheme/browser')();

The old CND url is now deprecated and will be removed in a next major release. It will continue to work for now.

- <script src="https://unpkg.com/css-prefers-color-scheme/browser.min"></script>
+ <script src="https://unpkg.com/css-prefers-color-scheme/dist/browser-global.js"></script>

September 17, 2021

• Updated: Support for PostCS 8+ (major).
• Updated: Support for Node 12+ (major).

May 24, 2019

• Updated: postcss to 7.0.16 (patch)
• Updated: Node 8+ compatibility (major)

November 10, 2018

• Updated: Project organization. No functional changes.

November 10, 2018

• Include CLI tool for transforming CSS without any installation
• Update documentation

November 4, 2018

• Preserve prefers-color-scheme queries by default for non-JS environments
• Remove prefers-color-scheme queries on the frontend for JS environments

November 3, 2018

• The client library now returns an object with various features, including:
  • scheme to get or set the preferred color scheme
  • hasNativeSupport to report whether prefers-color-scheme is supported
  • onChange to listen for when the preferred color scheme changes
  • removeListener to destroy the native prefers-color-scheme listener

September 24, 2018

• Initial version