---
title: useColorMode
description: "`useColorMode`は、現在のカラーモードを返すカスタムフックです。"
links:
  - source: https://github.com/yamada-ui/yamada-ui/tree/main/packages/react/src/hooks/use-color-mode
  - storybook: https://yamada-ui.github.io/yamada-ui?path=/story/hooks-usecolormode--basic
---

```tsx
const { colorMode } = useColorMode()

return <Text>The current colorMode is "{colorMode}"</Text>
```

## 使い方

```tsx
import { useColorMode } from "@yamada-ui/react"
```

```tsx
import { useColorMode } from "@/components/ui"
```

```tsx
import { useColorMode } from "@workspaces/ui"
```

```tsx
const { changeColorMode, colorMode, internalColorMode, toggleColorMode } =
  useColorMode()
```

:::tip
カラーモードの概要は[こちら](https://yamada-ui.com/docs/styling/color-mode.md)をご覧ください。
:::

### カラーモードを切り替える

- `colorMode`: 現在のカラーモードを提供します。
- `internalColorMode`: `system`を含めた現在のカラーモードを提供します。

```tsx
const { colorMode, internalColorMode, changeColorMode, toggleColorMode } =
  useColorMode()

return (
  <VStack>
    <Text>
      The current colorMode is "{colorMode}", internal colorMode is "
      {internalColorMode}"
    </Text>

    <Wrap gap="md">
      <Button onClick={() => changeColorMode("light")}>ライトモード</Button>
      <Button onClick={() => changeColorMode("dark")}>ダークモード</Button>
      <Button onClick={() => changeColorMode("system")}>システム</Button>
      <Button onClick={toggleColorMode}>
        {colorMode === "light" ? "ダーク" : "ライト"}モードに切り替える
      </Button>
    </Wrap>
  </VStack>
)
```