Przejdź do treści głównej
Wersja: Następna
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 →

I18nManager

Moduł I18nManager dostarcza narzędzi do zarządzania obsługą układu od prawej do lewej (RTL) dla języków takich jak arabski, hebrajski i innych. Udostępnia metody kontroli zachowania RTL oraz sprawdzania aktualnego kierunku układu.

Przykłady​

Zmiana pozycji i animacji w zależności od RTL​

Jeżeli pozycjonujesz elementy absolutnie, aby wyrównać je względem innych elementów flexbox, mogą nie być prawidłowo wyrównane w językach RTL. Wartość isRTL pozwala dostosować wyrównanie lub animacje.

Podczas tworzenia aplikacji​

Dokumentacja

Zatrzymuje działającą animację i resetuje wartość do oryginalnej.

isRTL​

typescript
static isRTL: boolean;

Wartość logiczna wskazująca, czy aplikacja jest obecnie w trybie układu RTL.

Wartość isRTL jest określana według następującej logiki:

  • Jeśli forceRTL jest true, isRTL zwraca true

  • Jeśli allowRTL jest false, isRTL zwraca false

  • W przeciwnym razie isRTL będzie true przy spełnieniu warunków:

    • iOS:
      • Preferowany język użytkownika na urządzeniu to język RTL
      • Zdefiniowane lokalizacje aplikacji uwzględniają język użytkownika (zdefiniowane w pliku projektu Xcode (knownRegions = (...)))
    • Android:
      • Preferowany język użytkownika na urządzeniu to język RTL
      • Plik AndroidManifest.xml aplikacji zawiera android:supportsRTL="true" w elemencie <application>

doLeftAndRightSwapInRTL​

typescript
static doLeftAndRightSwapInRTL: boolean;

Wartość logiczna wskazująca, czy właściwości stylu left i right powinny być automatycznie zamieniane w trybie RTL. Po włączeniu, left staje się right a right staje się left w układach RTL.

Metody​

allowRTL()​

typescript
static allowRTL: (allowRTL: boolean) => void;

Włącza lub wyłącza obsługę układu RTL dla aplikacji.

Parametry:

  • allowRTL (boolean): Określa, czy zezwolić na układ RTL

Ważne uwagi:

  • Zmiany obowiązują od następnego uruchomienia aplikacji, nie natychmiast

  • Ustawienie jest zachowywane przy ponownych uruchomieniach aplikacji

forceRTL()​

typescript
static forceRTL: (forced: boolean) => void;

Wymusza użycie układu RTL niezależnie od ustawień języka urządzenia. Przydatne głównie do testowania układów RTL podczas tworzenia aplikacji.

Unikaj wymuszania RTL w aplikacjach produkcyjnych, ponieważ wymaga pełnego ponownego uruchomienia aplikacji, co pogarsza doświadczenia użytkownika.

Parametry:

  • forced (boolean): Określa, czy wymusić układ RTL

Ważne uwagi:

  • Zmiany w pełni obowiązują od następnego uruchomienia aplikacji, nie natychmiast

  • Ustawienie jest zachowywane przy ponownych uruchomieniach aplikacji

  • Przeznaczone wyłącznie do tworzenia i testowania. W aplikacji produkcyjnej należy albo całkowicie wyłączyć RTL, albo obsłużyć go odpowiednio (patrz isRTL)

swapLeftAndRightInRTL()​

typescript
static swapLeftAndRightInRTL: (swapLeftAndRight: boolean) => void;

Zamienia właściwości stylu left i right w trybie RTL. Po włączeniu, left staje się right a right staje się left w układach RTL. Nie wpływa na wartość isRTL.