Skip to content
On this page

usePreferredDark

Category
Last Changed
3 months ago

Reactive dark theme preference.

Demo

Prefers Dark:
false

Usage

import { usePreferredDark } from '@vueuse/core'

const isDark = usePreferredDark()
import { usePreferredDark } from '@vueuse/core'

const isDark = usePreferredDark()

Component

This function also provides a renderless component version via the @vueuse/components package. Learn more about the usage.
<UsePreferredDark v-slot="{ prefersDark }">
  Prefers Dark: {{ prefersDark }}
</UsePreferredDark>
<UsePreferredDark v-slot="{ prefersDark }">
  Prefers Dark: {{ prefersDark }}
</UsePreferredDark>

Type Declarations

/**
 * Reactive dark theme preference.
 *
 * @see https://vueuse.org/usePreferredDark
 * @param [options]
 */
export declare function usePreferredDark(
  options?: ConfigurableWindow
): Ref<boolean>
/**
 * Reactive dark theme preference.
 *
 * @see https://vueuse.org/usePreferredDark
 * @param [options]
 */
export declare function usePreferredDark(
  options?: ConfigurableWindow
): Ref<boolean>

Source

SourceDemoDocs

Contributors

Anthony Fu
wheat
Alex Kozack
Antério Vieira

Changelog

v5.0.0-beta.2 on 5/25/2021
5bede - feat: introduce components & directives (#486)
usePreferredDark has loaded