React-Referenz
Ways
Root props
Gemeinsame Wurzel-Eigenschaften:
| Requisite | Typ | Notizen |
|---|---|---|
apiKey | Zeichenfolge | Erforderlich. |
lokal | Zeichenfolge | Aktuelle Zielgebietssprache. |
basisLocale | Zeichenfolge | Quellgebiet. |
persistLocaleCookie | boolean | Standard-Cookie-Richtlinie für die Root-Laufzeit. |
Kontext | string | objekt | Optionaler Wurzelkontext. |
cacheTtl | nummer | Cache-TTL für Übersetzungsanfragen. |
NachrichtenFormatter | 'waysParser' | 'keine' | fn | Parser- oder Formatiererüberschreibung. |
suspenseTimeoutMs | nummer | Maximale Zeit, für die das Rendern blockiert werden darf, bevor mit dem Fallback-Rendering fortgefahren wird. |
fetcher | typeof fetch | Benutzerdefinierte Abrufimplementierung. |
akzeptierteLokalisierungen | string[] | Optionale explizite Gebietsschemas-Liste. |
Scoped props
Verschachtelte Bereiche akzeptieren:
| Requisite | Typ | Notizen |
|---|---|---|
Kontext | string | objekt | Erforderlich. |
lokal | Zeichenfolge | Verfügbar, aber verwende einen verschachtelten Root für eine isolierte Locale-Sitzung. |
basisLocale | Zeichenfolge | Optionale Quellgebietsschema-Überschreibung für den Unterbaum. |
Komponenten | Aufzeichnung<string, komponent> | Komponenten, die in übersetzbarem Inhalt verwendet werden. |
T
T ist das JSX-erste Übersetzungsprimitive.
| Requisite | Typ | Notizen |
|---|---|---|
Kinder | ReactNode | Erforderlich. |
variablen | Record<string, unbekannt> | Interpolationseingabe. |
Kontext | string | objekt | Optionale Überschreibung des Blattkontexts. |
Komponenten | Aufzeichnung<string, komponent> | Komponentenabbildung für reichhaltige Inhalte. |
festgelegt | boolean | Übersetzung für festgelegte Markeninhalte überspringen. |
useT()
useT() gibt eine Übersetzungsfunktion für Strings, Attribute und Logik zurück.
const t = useT();
const label = t('Save changes');Laufzeit-Hooks
useTranslatedMemo()
Ein memoisiertes Wert, das neu berechnet wird, wenn sich die Übersetzungen ändern.
useTranslationLoading()
Gibt true zurück, solange der aktuelle Kontext noch geladen wird.
useCurrentLocale()
Liest die ausgewählte Gebietsschema für die aktuelle Root-Laufzeit.
useTargetLocale()
Liest die aktive Zielgebietssprache für den aktuellen Geltungsbereich.
useBaseLocale()
Liest die Quell-Locale für die aktuelle Root-Laufzeitumgebung.
useSetCurrentLocale()
Gibt den Setter für die Stamm-Laufzeitlokalisierung zurück.
useAcceptedLocales()
Liest die aufgelöste Liste der akzeptierten Gebietsschemas aus der Root-Runtime.
LanguageSwitcher
Gemeinsame Eigenschaften:
| Requisite | Typ | Notizen |
|---|---|---|
currentLocale | Zeichenfolge | Kontrollierte Region. |
onLocaleChange | (locale) => void | Änderungsbehandler. |
Richtung | 'hoch' | 'runter' | Menürichtung. |
Stile / KlassenNamen | Objekt | Styling-Überschreibungen. |
unstyled | boolean | Integrierte Stile deaktivieren. |
Utility exports
@18ways/react exportiert auch:
fetchAcceptedLocalesfetchConfigresolveOrigin