跳到主要内容
版本:0.78

PlatformColor

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

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

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

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

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

支持的颜色

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

开发者说明

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

示例

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

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