跳到主要内容
版本:0.79

PlatformColor

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

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

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

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

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

支持的颜色

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

开发者说明

如果您熟悉设计系统,另一种思考方式是 PlatformColor 让您能够利用本地设计系统的颜色令牌,从而使您的应用完美融合!

示例

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

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