JavaScript 与 React

在服务器端翻译内容,在 React 中渲染消息目录,并将语言区域路由接入应用。

JavaScript 应用在两个环节用到翻译:服务器将内容发送到本地化引擎,并保存翻译结果;用户界面加载译文消息,并以正确的值、语法和格式渲染。请根据你正在构建的应用部分,选择合适的软件包。

从服务器发起翻译 #

参阅 JavaScript API 指南,使用原生 fetch 创建翻译任务、跟踪进度并下载已完成的文件。请将 API 密钥保存在服务器端,并将每个任务的标识与该任务所翻译的源内容修订版本一同保存。

使用 LingoDotDevEngine 的应用可查阅单独的 SDK v0 参考。同步 API 和客户端批处理的说明仍保留在该文档中。

在 React 中渲染消息 #

React 将源消息及其上下文保留在组件中。消息目录提供译文模板,运行时则填入值,并创建由应用控制的 React 元素。渲染过程无需翻译 API 密钥。

先使用本地消息目录,从一个已翻译的组件开始。随着应用规模扩大,再提取并加载消息目录。Next.js Pages 和 TanStack Start 实践指南介绍了如何将这些消息目录与请求、路由和语言切换衔接起来。如果使用自定义路由器,locale-router 可提供底层的 URL 和语言偏好决策逻辑。

连接 Payload 应用 #

Payload CMS 插件提供字段结构定义,并在源内容发生变化时通知 Lingo.dev。Payload 集成用于配置需要翻译的内容及译文回写位置。

示例项目 #

这些代码仓库展示了源文件与应用加载流程如何配合。在调整示例以供使用前,请先查看各项目的依赖版本和配置;部分项目使用的软件包版本代际与这些手册所介绍的不同。在派生仓库中提交翻译任务前,请先连接你自己的 Lingo.dev 项目。

项目入门参考
React + Vite组件消息、消息提取和消息目录加载。
Next.js Pages页面消息和可识别语言区域的路由。
TypeScript 模块静态导出的语言区域数据。请使用 TypeScript 处理器支持的默认导出结构;不受支持的导出可能不会生成任何翻译单元。
iOSApple 资源和原生语言区域选择。
Android资源目录和字符串查找。
FlutterARB 元数据和生成的消息。
Markdown文档路径和前置元数据。
Markdoc + Next.js可翻译的标签属性和文档渲染。
OpenAPIAPI 规范中便于人阅读的描述。
Rails以语言区域为根键的 YAML 和框架查找机制。
Laravel资源文件和框架加载机制。

原生资源和文档使用 CLI 及其对应的格式处理器。出现在这组示例中,并不意味着它们需要 React 运行时。