跳到主要内容

PlatformColor

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

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

如果你向 PlatformColor 函数传递多个字符串值,它将把第一个值视为默认值,其余值视为备用值。

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

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

支持的颜色

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

开发者注意事项

如果你熟悉设计系统,另一种理解方式是 PlatformColor 允许你利用本地设计系统的颜色令牌,使你的应用程序能够完美融入其中!

示例

提供给 PlatformColor 函数的字符串值必须与应用程序运行的原生平台上存在的字符串相匹配。为了避免运行时错误,该函数应该通过 Platform.OS === 'platform'Platform.select() 进行平台检查封装,如上例所示。

注意:你可以在 PlatformColorExample.js 中找到一个演示 PlatformColor 正确和预期用法的完整示例。