Référence React
Ways
Root props
Propriétés racines communes :
| Prop | Type | Remarques |
|---|---|---|
apiKey | chaîne | Requis. |
locale | chaîne | Locale cible actuel. |
baseLocale | chaîne | Locale source. |
persistLocaleCookie | booléen | Politique par défaut des cookies de localisation pour le runtime racine. |
contexte | chaîne | objet | Contexte racine optionnel. |
cacheTtl | nombre | Durée de vie du cache pour les demandes de traduction. |
messageFormatter | 'waysParser' | 'aucun' | fn | Remplacement du parseur ou du formatteur. |
suspenseTimeoutMs | nombre | Durée maximale pendant laquelle le rendu bloquant est autorisé avant que le rendu de secours ne reprenne. |
fetcher | typeof fetch | Implémentation de récupération personnalisée. |
localesAcceptés | tableau de chaînes | Liste de locales explicites optionnelle. |
Scoped props
Les portées imbriquées acceptent :
| Prop | Type | Remarques |
|---|---|---|
contexte | chaîne | objet | Requis. |
locale | chaîne | Disponible, mais utilisez une racine imbriquée pour une session locale isolée. |
baseLocale | chaîne | Substitution facultative de la langue source pour le sous-arbre. |
composants | Enregistrement<string, composant> | Composants utilisés dans le contenu traduisible. |
T
T est le primitif de traduction orienté JSX.
| Prop | Type | Remarques |
|---|---|---|
enfants | ReactNode | Requis. |
vars | Enregistrement<chaîne, inconnu> | Entrée d'interpolation. |
contexte | chaîne | objet | Surcharge de contexte de feuille optionnelle. |
composants | Enregistrement<string, composant> | Cartographie des composants pour un contenu riche. |
fixe | booléen | Sauter la traduction pour le contenu fixe de type marque. |
useT()
useT() renvoie une fonction de traduction pour les chaînes, les attributs et la logique.
const t = useT();
const label = t('Save changes');Hooks d'exécution
useTranslatedMemo()
Une valeur mémorisée qui se recompute lorsque les traductions changent.
useTranslationLoading()
Renvoie true tant que le contexte actuel est encore en cours de chargement.
useCurrentLocale()
Lit la locale sélectionnée pour le runtime racine actuel.
useTargetLocale()
Lit la langue cible active pour la portée actuelle.
useBaseLocale()
Lit la locale source pour l’exécution racine actuelle.
useSetCurrentLocale()
Renvoie le setter pour la locale d'exécution racine.
useAcceptedLocales()
Lit la liste des paramètres régionaux acceptés résolus depuis l’environnement d’exécution racine.
LanguageSwitcher
Propriétés communes :
| Prop | Type | Remarques |
|---|---|---|
currentLocale | chaîne | Locale contrôlé. |
surChangementDeLocale | (locale) => vide | Gestionnaire de changement. |
direction | 'haut' | 'bas' | Direction du menu. |
styles / classNames | objet | Surcharges de style. |
non stylisé | booléen | Désactiver les styles intégrés. |
Utility exports
@18ways/react réexporte également :
fetchAcceptedLocalesfetchConfigrésoudreOrigine