# gt-next: General Translation Next.js SDK: GTProvider URL: https://generaltranslation.com/fr/docs/next/api/components/gtprovider.mdx --- title: GTProvider description: Référence de l’API pour le composant GTProvider --- ## Vue d’ensemble Le composant `` fournit le contexte General Translation (GT) à ses composants enfants, leur permettant d’accéder à du contenu traduit. Il est nécessaire pour toute traduction côté client dans votre application. ### Quand l’utiliser * Enveloppez l’ensemble de votre application dans `` pour activer les traductions côté client. * Lorsque vous travaillez avec des dictionnaires, vous pouvez, si nécessaire, spécifier un `id` afin de limiter les données de dictionnaire envoyées au client, ce qui optimise les performances pour les dictionnaires volumineux. * Le composant `` est utilisé à la fois pour [le `` inline](/docs/next/guides/t) et les [dictionnaires](/docs/next/guides/dictionaries). ## Référence ### Props ### Description | Prop | Description | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `children` | N’importe quel composant, ou le parent de n’importe quel composant, qui doit traduire du contenu ou accéder à des informations de traduction côté client. Cela inclut tous les composants qui utilisent ``, `useGT` ou d’autres utilitaires de traduction. | | `id?` | L’ID d’un dictionnaire imbriqué permettant de limiter les données envoyées au client. C’est utile pour les grands projets avec des dictionnaires volumineux. | | `locale?` | Une substitution facultative du paramètre régional. Si elle est fournie, ce paramètre régional sera utilisé à la place de celui détecté automatiquement. | | `region?` | Une substitution facultative de la région pour un formatage spécifique au paramètre régional. | ### Renvoie `JSX.Element|undefined` contenant les enfants transmis à ce composant. ## Exemple ### Utilisation de base Encapsulez votre application dans `` afin de lui fournir le contexte de traduction. ```jsx title="layout.js" copy import { GTProvider } from 'gt-next'; export default function RootLayout({ children }) { return ( // [!code highlight] {children} // [!code highlight] ); } ``` ### Utiliser la prop `id` pour les sous-ensembles Spécifiez la prop `id` pour optimiser les performances en n'envoyant au client qu'un sous-ensemble du dictionnaire. ```jsx title="layout.js" copy import { GTProvider } from 'gt-next'; export default function RootLayout({ children }) { return ( // [!code highlight] {children} ); } ``` *** ## Remarques * `` doit encapsuler tous les composants `` et les autres composants liés à la traduction dans les composants client. Pour en savoir plus, consultez [cette page](/docs/next/guides/t). * Pour les traductions côté serveur, `` n’est pas nécessaire, mais peut tout de même être utilisé. ## Étapes suivantes * En savoir plus sur le composant [``](/docs/next/guides/t) pour traduire du texte et des composants.