# gt-next: General Translation Next.js SDK: GTProvider URL: https://generaltranslation.com/zh/docs/next/api/components/gtprovider.mdx --- title: GTProvider description: GTProvider 组件的 API 参考 --- ## 概览 `` 组件会向其子组件提供 General Translation (GT) 上下文，使其能够访问已翻译的内容。它是应用中进行任何客户端翻译所必需的。 ### 适用场景 * 将整个应用包裹在 `` 中，以启用客户端翻译。 * 使用字典时，可选指定 `id`，以限制发送到客户端的字典数据量，从而在字典较大时优化性能。 * `` 组件同时用于 [内联 ``](/docs/next/guides/t) 和 [字典](/docs/next/guides/dictionaries)。 ## 参考 ### 属性 ### 说明 | Prop | 说明 | | ---------- | --------------------------------------------------------------- | | `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)。