跳到主要内容

useColorScheme

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

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

返回值​

  • 'light':应用浅色颜色方案
  • 'dark':应用深色颜色方案
  • null:如果原生 Appearance 模块不可用,可能会返回此值

示例​

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