PlatformColor

Nieoficjalne Tłumaczenie Beta

Ta strona została przetłumaczona przez PageTurner AI (beta). Nie jest oficjalnie zatwierdzona przez projekt. Znalazłeś błąd? Zgłoś problem →

js

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

Funkcji PlatformColor możesz użyć, aby uzyskać dostęp do natywnych kolorów na docelowej platformie, podając odpowiadający im ciąg znaków. Przekazujesz ciąg do funkcji PlatformColor i – o ile istnieje on na danej platformie – otrzymasz odpowiedni natywny kolor, który możesz zastosować w dowolnej części aplikacji.

Jeśli przekażesz do funkcji PlatformColor więcej niż jeden ciąg znaków, pierwsza wartość będzie traktowana jako domyślna, a pozostałe jako wartości zapasowe.

js

PlatformColor('bogusName', 'linkColor');

Ponieważ natywne kolory mogą być wrażliwe na motywy i/lub wysoki kontrast, ta specyficzna dla platformy logika działa również wewnątrz twoich komponentów.

Obsługiwane kolory

Pełną listę obsługiwanych typów kolorów systemowych znajdziesz tutaj:

• Android:

  • R.attr - prefiks ?attr
  • R.color - prefiks @android:color

• iOS (notacje Objective-C i Swift):

  • UIColor Standard Colors
  • UIColor UI Element Colors

Uwagi dla deweloperów

Web

If you’re familiar with design systems, another way of thinking about this is that PlatformColor lets you tap into the local design system's color tokens so your app can blend right in!

Przykład

Ciąg znaków przekazany do funkcji PlatformColor musi dokładnie odpowiadać ciągowi istniejącemu na natywnej platformie, na której działa aplikacja. Aby uniknąć błędów w czasie wykonywania, funkcję należy opakować w sprawdzenie platformy za pomocą Platform.OS === 'platform' lub Platform.select(), jak pokazano w powyższym przykładzie.

Uwaga: Kompletny przykład demonstrujący poprawne użycie PlatformColor znajdziesz w pliku PlatformColorExample.js.