# gt-next: General Translation Next.js SDK: GTProvider URL: https://generaltranslation.com/ru/docs/next/api/components/gtprovider.mdx --- title: GTProvider description: Справочник по API компонента GTProvider --- ## Обзор Компонент `` предоставляет своим дочерним элементам контекст General Translation (GT), чтобы они могли получать доступ к переведённому содержимому. Он обязателен для любых клиентских переводов в вашем приложении. ### Когда использовать * Оберните всё приложение в ``, чтобы включить клиентские переводы. * При работе со словарями при необходимости укажите `id`, чтобы ограничить объём данных словаря, отправляемых на клиент, и повысить производительность при работе с большими словарями. * Компонент `` используется как для [встроенного компонента ``](/docs/next/guides/t), так и для [словарей](/docs/next/guides/dictionaries). ## Справочник ### Свойства ### Описание | Prop | Description | | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `children` | Любой компонент или родительский компонент, которому нужно переводить текст или получать доступ к информации о переводах на стороне клиента. Сюда относятся любые компоненты, использующие ``, `useGT` или другие утилиты перевода. | | `id?` | id вложенного словаря, чтобы ограничить объём данных, отправляемых клиенту. Это полезно для крупных проектов с большими словарями. | | `locale?` | Необязательное переопределение локали. Если указано, будет использоваться эта локаль вместо автоматически определённой. | | `region?` | Необязательное переопределение региона для форматирования с учётом локали. | ### Возвращает `JSX.Element|undefined`, содержащий дочерние элементы, переданные этому компоненту. ## Пример ### Базовое использование Оберните приложение в ``, чтобы передать ему контекст перевода. ```jsx title="layout.js" copy import { GTProvider } from 'gt-next'; export default function RootLayout({ children }) { return ( // [!code highlight] {children} // [!code highlight] ); } ``` ### Использование свойства `id` для подмножеств Укажите свойство `id`, чтобы повысить производительность, передавая клиенту только подмножество словаря. ```jsx title="layout.js" copy import { GTProvider } from 'gt-next'; export default function RootLayout({ children }) { return ( // [!code highlight] {children} ); } ``` *** ## Примечания * `` должен оборачивать все компоненты `` и другие связанные с переводом компоненты внутри клиентских компонентов. Подробнее см. [здесь](/docs/next/guides/t). * Для переводов на сервере `` не обязателен, но его всё равно можно использовать. ## Что дальше * Подробнее о [компоненте ``](/docs/next/guides/t) для перевода текста и компонентов.