跳到主要内容

PlatformColor

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

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

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

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

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

支持的颜色

如需查看支持的系统颜色的完整列表,请参考

开发者说明

如果你熟悉设计系统,另一种理解方式是 PlatformColor 让你能够访问本地设计系统的颜色 tokens,从而使你的应用能够完美融入其中!

示例

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

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