SuperAPI AI 工具集

paraglide-js

智能体与模型

查看项目

更新于 10-16 09:55

技能介绍

用途:Paraglide JS 是编译型 i18n 库,将翻译文件编译为可摇树优化的 JS 函数,每条消息生成一个函数,未使用的消息不会被打包。

主要能力:翻译源文件放在 messages/(如 en.json、de.json),配置在 project.inlang/settings.json,编译输出到 src/paraglide/。生成 messages.js(消息函数)、runtime.js(getLocale、setLocale、locales、sourceLocale)、server.js(paraglideMiddleware(),用于 SSR)。消息可带参数,例如 m.greeting({ name: "Alice" }),也可用 { locale: "de" } 按次覆盖语言。语言检测通过 strategy 配置有序回退链,常见策略有 url、cookie、preferredLanguage、globalVariable、localStorage、baseLocale,并可配置 urlPatterns、cookieName。

使用方式:通过打包器插件(Vite/Webpack/Rollup/Rolldown)或 CLI 运行编译器,输出固定为 ./src/paraglide/。Vite 用法为 import { paraglideVitePlugin } from "@inlang/paraglide-js" 并在配置中调用 paraglideVitePlugin()。SSR 场景使用 paraglideMiddleware(),其基于 AsyncLocalStorage 处理请求级 locale;真实应用必须在 inlang 项目设置中覆盖 getLocale/setLocale,默认的全局变量不适合 SSR。

适用场景:需要多语言、SSR/SSG、按需打包消息的前端与全栈项目。

限制:文档仅描述上述机制与配置项,未提供价格、功能效果或性能数据;具体集成细节需参考资料中列出的 setup、routing-and-strategy、rendering、advanced 等参考文件。