跳至主要内容

Appearance

import {Appearance} from 'react-native';

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

开发者说明​

Appearance API 受到 W3C 媒体查询草案 的启发。配色方案偏好是根据 prefers-color-scheme CSS 媒体特性 建模的。

示例​

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

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

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

参考

方法​

getColorScheme()​

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

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

支持的配色方案

  • light：用户偏好浅色主题。
  • dark：用户偏好深色主题。
  • null：用户未指定首选颜色主题。

另请参阅：useColorScheme Hook。

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

setColorScheme()​

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

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

支持的配色方案

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

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

addChangeListener()​

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

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