Components
GTProvider
Riferimento API per il componente <GTProvider>
Panoramica
Il componente <GTProvider> fornisce il contesto di General Translation (GT) ai componenti figli, permettendo loro di accedere ai contenuti tradotti.
È obbligatorio per qualsiasi traduzione lato client nella tua applicazione.
Quando utilizzarlo
- Wrappa l'intera applicazione con
<GTProvider>per abilitare le traduzioni lato client. - Quando lavori con i dizionari, puoi opzionalmente specificare un
idper limitare i dati del dizionario inviati al client, ottimizzando le prestazioni con dizionari di grandi dimensioni. - Il componente
<GTProvider>viene utilizzato sia per inline<T>sia per dictionaries.
Riferimenti
Proprietà
Prop
Type
Descrizione
| Prop | Descrizione |
|---|---|
children | Qualsiasi componente, o il componente padre di qualunque componente, che debba tradurre o accedere alle informazioni di traduzione sul lato client. Dovrebbe includere qualsiasi componente che utilizzi <T>, useGT o altre utility di traduzione. |
id? | L’ID di un dizionario nidificato per limitare i dati inviati al client. Utile per progetti di grandi dimensioni con dizionari estesi. |
Restituisce
JSX.Element|undefined che contiene i children passati a questo componente.
Esempio
Utilizzo di base
Racchiudi la tua applicazione in <GTProvider> per fornire il contesto di traduzione all’app.
import { GTProvider } from 'gt-next';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<GTProvider> // [!code highlight]
{children}
</GTProvider> // [!code highlight]
</body>
</html>
);
}Utilizzo della prop id per i sottoinsiemi
Specifica la prop id per ottimizzare le prestazioni inviando al client solo un sottoinsieme del dizionario.
import { GTProvider } from 'gt-next';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<GTProvider id="nested.dictionary.key"> // [!code highlight]
{children}
</GTProvider>
</body>
</html>
);
}Note
- Il
<GTProvider>deve racchiudere tutti i componenti<T>e gli altri componenti legati alla traduzione all’interno dei componenti client. Scopri di più qui. - Per le traduzioni lato server,
<GTProvider>non è obbligatorio ma può comunque essere usato.
Prossimi passi
- Scopri di più sul componente
<T>per tradurre testo e componenti.
Come valuti questa guida?