如何在 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怎么用  宙斯浏览器文件分类查看教程 快速筛选视频文档与图片方法  如何基于云服务器快速搭建个人网站?