跳到主要内容

PlatformColor

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

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

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

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

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

支持的颜色

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

开发者注意事项

如果你熟悉设计系统,另一种思考方式是 PlatformColor 允许你利用本地设计系统的颜色令牌,这样你的应用程序就能完美融入!

示例

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

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