跳到主要內容

PlatformColor

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

你可以使用 PlatformColor 函數,透過提供原生顏色的對應字串值來存取目標平台上的原生顏色。你傳遞一個字串給 PlatformColor 函數,如果該平台存在該顏色,它將返回對應的原生顏色,你可以將其應用於應用程式的任何部分。

如果你傳遞多個字串值給 PlatformColor 函數,它會將第一個值視為預設值,其餘值視為備用值。

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

由於原生顏色可能對主題和/或高對比度敏感,這種平台特定的邏輯也會在你的組件內部轉換。

支援的顏色

如需支援的系統顏色類型的完整列表,請參閱

開發者筆記

如果你熟悉設計系統,另一種思考方式是 PlatformColor 讓你能夠利用本地設計系統的顏色令牌,讓你的應用程式能夠完美融入!

範例

提供給 PlatformColor 函數的字串值必須與應用程式運行的原生平台上的字串完全一致。為了避免運行時錯誤,該函數應包裹在平台檢查中,可以透過 Platform.OS === 'platform'Platform.select(),如上面的範例所示。

注意: 你可以在 PlatformColorExample.js 中找到一個完整的範例,示範了 PlatformColor 的正確且預期的用法。