1---
2category: Browser
3---
4 
5# usePreferredColorScheme
6 
7Reactive [prefers-color-scheme](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme) media query.
8 
9## Usage
10 
11```ts
12import { usePreferredColorScheme } from '@vueuse/core'
13 
14const preferredColor = usePreferredColorScheme()
15```
16 
17## Component Usage
18 
19```vue
20<template>
21  <UsePreferredColorScheme v-slot="{ colorScheme }">
22    Preferred Color Scheme: {{ colorScheme }}
23  </UsePreferredColorScheme>
24</template>
25```
26 
27## Type Declarations
28 
29```ts
30export type ColorSchemeType = "dark" | "light" | "no-preference"
31/**
32 * Reactive prefers-color-scheme media query.
33 *
34 * @see https://vueuse.org/usePreferredColorScheme
35 * @param [options]
36 *
37 * @__NO_SIDE_EFFECTS__
38 */
39export declare function usePreferredColorScheme(
40  options?: ConfigurableWindow,
41): ComputedRef<ColorSchemeType>
42```
43