跳到主要内容

useColorScheme

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

useColorScheme React hook 提供并订阅来自 Appearance 模块的颜色方案更新。返回值表示当前用户首选的颜色方案。该值可能会稍后更新,通过用户直接操作(例如设备设置中的主题选择)或按计划(例如遵循昼夜循环的亮色和暗色主题)。

支持的颜色方案

  • "light":用户偏好亮色主题。
  • "dark":用户偏好暗色主题。
  • null:用户未指定偏好的颜色主题。

示例

你可以在 AppearanceExample.js 中找到一个完整的示例,演示了此 Hook 与 React context 的结合使用,为你的应用程序添加亮色和暗色主题支持。