按分类浏览
GrapesJS I18n
GrapesJS i18n 插件为编辑器界面提供多语言支持。把面板标签、按钮文案、提示气泡与区块名称翻译成任意语言——或让用户在运行时切换语言。这些扩展包含常用语言的现成语言包,以及添加自定义翻译的工具。浏览免费与付费的 GrapesJS 国际化插件,并查看各自的语言覆盖度。
关于 GrapesJS I18n
GrapesJS 内置 i18n 模块,统一管理编辑器界面中所有面向用户的字符串——面板标题、按钮文案、提示文本、区块名称与错误信息。默认情况下编辑器只自带英文字符串。GJS.Market 上的 GrapesJS i18n 插件在此基础上提供现成语言包,以及面向多语言部署的翻译管理工具。语言包插件为特定语言提供完整的翻译字符串集——西班牙语、法语、德语、葡萄牙语、意大利语、阿拉伯语、中文、日语和韩语均有对应包。部分语言包还会翻译默认区块名称与 trait 标签,让用户获得完整的本地化体验。进阶 i18n 插件支持运行时切换语言——在编辑器工具栏加入语言选择器,无需刷新页面即可重新加载字符串。如果你要为国际市场打造基于 GrapesJS 的产品,建议先引入目标语言的核心语言包,然后查看覆盖度评级——有些包翻译了 100% 的字符串,另一些只覆盖最常见的界面元素。
GrapesJS I18n — 常见问题
- 如何修改 GrapesJS 编辑器的语言?
- 在初始化编辑器时传入 i18n 选项:把 locale 设为你的语言代码,并在 messages 中提供对应的字符串集合。GrapesJS 只自带英文,因此这些字符串来自语言包或你自己的对象。未翻译的条目会回退到 fallbackLocale,这样即使语言包不完整界面依然可用。
- GrapesJS 开箱支持哪些语言?
- 核心库只自带英文字符串。其余全部来自语言包,本分类覆盖了常用的那些——西班牙语、法语、德语、葡萄牙语、意大利语、阿拉伯语、中文、日语和韩语。各语言包的覆盖度不同,请查看条目上的评级:有的翻译了全部字符串,有的只覆盖最显眼的界面元素。
- 用户能在运行时切换编辑器语言吗?
- 可以。editor.I18n.setLocale 会切换当前语言,界面无需刷新页面即可重新渲染。本分类中的多个插件把这一能力封装成工具栏的语言选择器。切换结果需要你自己持久化——存到 localStorage 或用户资料中——因为 GrapesJS 不会跨会话记住它。
- i18n 插件也会翻译区块和 trait 名称吗?
- 部分会,而这正是「翻译了一半的编辑器」和「真正本地化的编辑器」之间的差别。区块标签、分类标题与 trait 名称属于独立于核心界面的字符串集合,因此语言包可能覆盖了面板,却把你的区块留在英文状态。你自己注册的区块始终需要自备标签——把它们放进同一语言下的 messages 集合即可。
- 如何翻译我自己的自定义字符串?
- 按照 GrapesJS 相同的嵌套键结构,把它们加入对应语言的 messages 对象,然后用 editor.I18n.t('your.key') 读取。由于你的键会并入与核心相同的存储,一个语言包加上你的补充,就构成整个编辑器统一的翻译层。