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 处理器支持的默认导出结构;不受支持的导出可能不会生成任何翻译单元。 |
| iOS | Apple 资源和原生语言区域选择。 |
| Android | 资源目录和字符串查找。 |
| Flutter | ARB 元数据和生成的消息。 |
| Markdown | 文档路径和前置元数据。 |
| Markdoc + Next.js | 可翻译的标签属性和文档渲染。 |
| OpenAPI | API 规范中便于人阅读的描述。 |
| Rails | 以语言区域为根键的 YAML 和框架查找机制。 |
| Laravel | 资源文件和框架加载机制。 |