跳到主要内容

Appearance

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

Appearance 模块公开了有关用户外观偏好的信息，例如他们偏好的配色方案（浅色或深色）。

开发者 notes​

Appearance API 的灵感来源于 W3C 的 Media Queries 草案。配色方案偏好是仿照 prefers-color-scheme CSS 媒体功能建模的。

示例​

你可以使用 Appearance 模块来确定用户是否偏好深色配色方案

tsx
const colorScheme = Appearance.getColorScheme();
if (colorScheme === 'dark') {
  // Use dark color scheme
}

尽管配色方案立即可用，但这可能会发生变化（例如，在日出或日落时计划的配色方案更改）。任何依赖于用户首选配色方案的渲染逻辑或样式都应尝试在每次渲染时调用此函数，而不是缓存该值。例如，你可以使用 useColorScheme React Hook，因为它提供并订阅配色方案更新，或者你可以使用内联样式而不是在 StyleSheet 中设置值。

参考

方法​

getColorScheme()​

tsx
static getColorScheme(): 'light' | 'dark' | null;

指示当前用户首选的配色方案。该值可能会在稍后更新，无论是通过直接用户操作（例如，设备设置中的主题选择或通过 setColorScheme 选择的应用程序级用户界面样式）还是按计划（例如，遵循昼/夜循环的浅色和深色主题）。

支持的配色方案

  • light：用户偏好浅色主题。
  • dark：用户偏好深色主题。
  • null：用户未指示首选的配色方案。

另请参阅：useColorScheme Hook。

注意：使用 Chrome 调试时，getColorScheme() 将始终返回 light。

setColorScheme()​

tsx
static setColorScheme('light' | 'dark' | null): void;

强制应用程序始终采用浅色或深色界面样式。默认值为 null，这会导致应用程序继承系统的界面样式。如果分配不同的值，则新样式将应用于应用程序和应用程序内的所有原生元素（Alerts、Pickers 等）。

支持的配色方案

  • light：应用浅色用户界面样式。
  • dark：应用深色用户界面样式。
  • null：遵循系统的界面样式。

注意：此更改不会影响系统选择的界面样式或在其他应用程序中设置的任何样式。

addChangeListener()​

tsx
static addChangeListener(
  listener: (preferences: {colorScheme: 'light' | 'dark' | null}) => void,
): NativeEventSubscription;

添加一个事件处理程序，当外观偏好更改时触发。