PlatformColor

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

PlatformColor 関数を使用すると、ネイティブカラーに対応する文字列値を指定することで、ターゲットプラットフォームのネイティブカラーにアクセスできます。文字列を PlatformColor 関数に渡すと、そのプラットフォームに存在する場合は対応するネイティブカラーが返され、アプリケーションの任意の部分に適用できます。

複数の文字列値を PlatformColor 関数に渡すと、最初の値がデフォルト値として扱われ、残りの値がフォールバック値として扱われます。

PlatformColor('bogusName', 'linkColor');

ネイティブカラーはテーマやハイコントラストに影響を受ける可能性があるため、このプラットフォーム固有のロジックはコンポーネント内でも機能します。

サポートされているカラー

サポートされているシステムカラーの種類の完全なリストについては、以下を参照してください。

• Android
  • R.attr - ?attr プレフィックス
  • R.color - @android:color プレフィックス
• iOS（Objective-CとSwift表記）
  • UIColor標準カラー
  • UIColor UI要素カラー

開発者向けノート

ウェブ

デザインシステムに精通している場合は、PlatformColor を使用すると、ローカルデザインシステムのカラートークンを利用して、アプリをシームレスに統合できるという別の考え方があります。

例

PlatformColor 関数に指定する文字列値は、アプリが実行されているネイティブプラットフォームに存在する文字列と一致する必要があります。ランタイムエラーを回避するために、この関数は、上記の例に示すように、Platform.OS === 'platform' または Platform.select() を使用したプラットフォームチェックでラップする必要があります。

注記: PlatformColor の適切な使用方法を示す完全な例は、PlatformColorExample.js で確認できます。