跳到主要内容
版本:Next

useColorScheme

React TSX
import {useColorScheme} from 'react-native';

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

返回值​

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

示例​

你可以在 AppearanceExample.js 中查看完整示例,了解如何将此 Hook 与 React context 结合,为应用添加浅色和深色主题支持。