跳到主要内容
版本:Next

useColorScheme

tsx
import {useColorScheme} from 'react-native';

useColorScheme 这个 React Hook 提供并订阅来自 Appearance 模块的颜色方案更新。返回值表示当前激活的颜色方案。该值可能会在之后更新,无论是通过直接的用户操作(例如在设备设置中选择主题,或通过 setColorScheme 以应用级别选择用户界面样式)还是按计划更新(例如遵循昼夜循环的浅色和深色主题)。

返回值

  • 'light':应用浅色配色方案。
  • 'dark':应用深色配色方案。
  • null:如果原生 Appearance 模块不可用,则可能返回。

示例

你可以在 AppearanceExample.js 中找到一个完整示例,该示例展示了如何将这个 Hook 与 React context 结合使用,为你的应用添加对浅色和深色主题的支持。