如何在 Django 中实现前端按钮文本的国际化翻译
发布时间 - 2026-01-21 00:00:00 点击率:次本文介绍如何结合 django 内置 i18n 机制,为 javascript 中定义的按钮文案(如 vue/react 或纯 js 配置对象)添加多语言支持,重点解决静态 js 对象内文本的可翻译性问题。
在 Django 构建的多语言网站中,后端模板(.html)中的文本可通过 {% trans %} 或 gettext 轻松翻译,但前端 JavaScript 中硬编码的字符串(如按钮配置对象)默认无法被 makemessages 扫描识别,因此需采用“服务端预渲染 + 客户端注入”的方式实现国际化。
核心思路是:将待翻译的文本在 Python 视图或模板上下文中提前翻译好,并通过安全方式传递给前端 JavaScript。以下是推荐的实践步骤:
✅ 步骤一:在视图中准备翻译后的文本
在对应的视图(如 views.py)中导入并调用 gettext:
from django.utils.translation import gettext as _
def your_view(request):
context = {
'add_to_purchase_list': _("Add to purchase list"),
'recipe_in_purchase_list': _("Recipe in purchase list"),
}
return render(request, 'your_template.html', context)✅ 步骤二:在模板中安全注入翻译文本到 JS
在 HTML 模板(如 your_template.html)中,使用 json_script 过滤器将翻译结果序列化为 JSON 并嵌入页面(避免 XSS 风险):
{{ add_to_purchase_list|json_script:"i18n-translations" }}
更稳妥的做法是统一构造一个翻译字典:
# views.py
context = {
'i18n_messages': {
'add_to_purchase_list': _("Add to purchase list"),
'recipe_in_purchase_list': _("Recipe in purchase list"),
}
}
{{ i18n_messages|json_script:"i18n-messages" }}
⚠️ 注意事项
- ❌ 不要直接在 .js 文件中调用 gettext —— 静态 JS 文件不经过 Django 模板引擎,_() 不会被执行,也无法触发 makemessages 提取;
- ✅ 确保已启用 Django 国际化中间件('django.middleware.locale.LocaleMiddleware')并正确配置 LANGUAGES 和 USE_I18N = True;
- ✅ 运行 python manage.py makemessages -l en -l zh_Hans 生成 .po 文件,并完成翻译后执行 compilemessages;
- ✅ 若项目使用构建工具(如 Webpack/Vite),也可考虑将翻译数据作为全局变量注入或通过 API 接口获取,但服务端模板注入方式最轻量、兼容性最强。
通过该方案,既保持了 JavaScript 配置的清晰结构,又完全复用 Django 的成熟 i18n 生态,实现按钮文案的无缝多语言切换。
# vue
# react
# javascript
# python
# java
# html
# js
# 前端
# json
# go
# vite
# 编码
相关栏目:
【
网站优化151355 】
【
网络推广146373 】
【
网络技术251813 】
【
AI营销90571 】
相关推荐:
品牌网站制作公司有哪些,买正品品牌一般去哪个网站买?
javascript日期怎么处理_如何格式化输出
如何在腾讯云服务器上快速搭建个人网站?
如何快速查询网址的建站时间与历史轨迹?
html5如何设置样式_HTML5样式设置方法与CSS应用技巧【教程】
Laravel如何配置Horizon来管理队列?(安装和使用)
企业在线网站设计制作流程,想建设一个属于自己的企业网站,该如何去做?
佛山网站制作系统,佛山企业变更地址网上办理步骤?
Laravel如何操作JSON类型的数据库字段?(Eloquent示例)
微博html5版本怎么弄发语音微博_语音录制入口及时长限制操作【教程】
如何快速生成橙子建站落地页链接?
Laravel如何生成API文档?(Swagger/OpenAPI教程)
Laravel如何使用缓存系统提升性能_Laravel缓存驱动和应用优化方案
Laravel的路由模型绑定怎么用_Laravel Route Model Binding简化控制器逻辑
国美网站制作流程,国美电器蒸汽鍋怎么用官方网站?
Laravel队列任务超时怎么办_Laravel Queue Timeout设置详解
浅谈Javascript中的Label语句
如何用狗爹虚拟主机快速搭建网站?
Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱动更新修复【详解】
如何在阿里云虚拟主机上快速搭建个人网站?
Laravel怎么实现一对多关联查询_Laravel Eloquent模型关系定义与预加载【实战】
Laravel路由Route怎么设置_Laravel基础路由定义与参数传递规则【详解】
Android Socket接口实现即时通讯实例代码
如何获取免费开源的自助建站系统源码?
高配服务器限时抢购:企业级配置与回收服务一站式优惠方案
BootStrap整体框架之基础布局组件
Laravel API资源(Resource)怎么用_格式化Laravel API响应的最佳实践
详解ASP.NET 生成二维码实例(采用ThoughtWorks.QRCode和QrCode.Net两种方式)
Laravel如何使用Blade模板引擎?(完整语法和示例)
Laravel如何使用Socialite实现第三方登录?(微信/GitHub示例)
Laravel如何使用Sanctum进行API认证?(SPA实战)
Laravel Eloquent关联是什么_Laravel模型一对一与一对多关系精讲
Laravel任务队列怎么用_Laravel Queues异步处理任务提升应用性能
Laravel如何实现邮箱地址验证功能_Laravel邮件验证流程与配置
零基础网站服务器架设实战:轻量应用与域名解析配置指南
Linux系统命令中tree命令详解
香港网站服务器数量如何影响SEO优化效果?
Laravel如何实现一对一模型关联?(Eloquent示例)
如何在Windows环境下新建FTP站点并设置权限?
如何用好域名打造高点击率的自主建站?
原生JS获取元素集合的子元素宽度实例
浅述节点的创建及常见功能的实现
JavaScript数据类型有哪些_如何准确判断一个变量的类型
微信小程序 scroll-view组件实现列表页实例代码
JavaScript如何操作视频_媒体API怎么控制播放
如何破解联通资金短缺导致的基站建设难题?
济南网站建设制作公司,室内设计网站一般都有哪些功能?
JavaScript中如何操作剪贴板_ClipboardAPI怎么用
宙斯浏览器文件分类查看教程 快速筛选视频文档与图片方法
如何基于云服务器快速搭建个人网站?

