跳到主要内容
版本:Next

PlatformColor

JavaScript
PlatformColor(color1, [color2, ...colorN]);

您可以通过提供对应的原生颜色字符串值,使用 PlatformColor 函数访问目标平台上的原生颜色。将一个字符串传递给 PlatformColor 函数,如果该颜色在该平台上存在,它就会返回对应的原生颜色,您可以在应用程序的任意部分使用它。

如果向 PlatformColor 函数传递多个字符串值,它会将第一个值视为默认值,其余值视为回退值。

JavaScript
PlatformColor('bogusName', 'linkColor');

由于原生颜色可能会对主题和/或高对比度敏感,这种平台特定逻辑也会在您的组件内部生效。

支持的颜色

有关支持的系统颜色类型完整列表,请参见:

开发者说明

信息

如果您熟悉设计系统,可以这样理解:PlatformColor 让您能够直接使用本地设计系统的颜色标记,从而让您的应用自然融入其中!

示例

传递给 PlatformColor 函数的字符串值必须与应用运行所在原生平台中的字符串保持一致。为了避免运行时错误,该函数应通过平台检查进行包装,方式可以是 Platform.OS === 'platform'Platform.select(),如上面的示例所示。

备注

您可以在 PlatformColorExample.js 中找到一个演示 PlatformColor 正确、预期用法的完整示例。