﻿---
description: Компонент, позволяющий переопределить цветовую схему сайта.
tags: provider
---

# ColorSchemeProvider \[tag:component]

Компонент, позволяющий переопределить цветовую схему сайта.

## Цветовая схема

Задаётся свойством `value`.

* `"light"` — светлая схема;
* `"dark"` — тёмная схема.

```jsx
<ColorSchemeProvider value="dark">
  {/* часть вашего приложения, требующая переопределения цветовой схемы */}
</ColorSchemeProvider>
```

Вставить часть про кастомизацию.

> При переопределении цветовой схемы убедитесь, что компонент, обёрнутый в `ColorSchemeProvider`,
> принимает свойство `className`, иначе визуальные изменения соответствующей схемы не будут применены.
>
> ```jsx
> function BadComponent({ children }) {
>   return (
>     <Box padding="system">
>       <Button mode="primary" appearance="accent">
>         Акцентная кнопка светлой схемы 😔
>       </Button>
>     </Box>
>   );
> }
> function GoodComponent({ className, children }) {
>   return (
>     <Box padding="system" className={className}>
>       <Button mode="primary" appearance="accent">
>         Акцентная кнопка тёмной схемы 😎
>       </Button>
>     </Box>
>   );
> }
> function InfoBoard({ children }) {
>   return (
>     <ColorSchemeProvider value="dark">
>       <BadComponent /> {/* схема "dark" не применяется */}
>       <GoodComponent /> {/* схема "dark" применяется */}
>     </ColorSchemeProvider>
>   );
> }
> ```

## Хук useColorScheme \[#use-color-scheme]

Для получения значения текущей цветовой схемы используйте хук `useColorScheme`:

```jsx
import { useColorScheme } from '@vkontakte/vkui';
```

```jsx
const colorScheme = useColorScheme();
```

## Свойства и методы \[#api]

### ColorSchemeProvider

| Свойство          | Тип               | По умолчанию | Описание        |
| ----------------- | ----------------- | ------------ | --------------- |
| `**children** \*` | `ReactNode`       | `-`          | Содержимое.     |
| `**value** \*`    | `ColorSchemeType` | `-`          | Цветовая схема. |

### useColorScheme

*Не принимает свойств*
