布局页中如何保障翻译JSON资源加载完成后再执行依赖翻译的脚本
问题根因
- 时序错位:
$.getJSON是异步HTTP请求,当前代码把翻译资源加载放在jQuery DOM就绪回调中执行,而Enumerators.js是同步顺序加载的,会在脚本解析阶段立刻执行Translation('New', 'EnumToolBar')调用。此时翻译JSON尚未拉取完成,全局变量jsonTranstation仍为null,触发兜底逻辑返回'--'。 - 固化赋值逻辑错误:枚举对象的
text值在脚本加载时就被固定为当时的返回结果,没有等待翻译资源加载完成后重新赋值。
落地解决步骤
1. 重构Translation.js,将翻译加载封装为可控时序的Promise
移除原代码中DOM就绪触发的异步加载逻辑,把翻译资源拉取改成可等待的Promise结构,保证调用方可以明确感知加载完成时机:
'use strict'; // 全局存储翻译资源 let jsonTranstation = null; /** * 拉取指定语言的翻译文件 * @param {string} locale 语言标识 * @returns {Promise} 翻译文件内容 */ const getTranslationJson = (locale = 'en-EN') => { return new Promise((resolve, reject) => { // 翻译资源已加载时直接返回缓存 if (jsonTranstation) { resolve(jsonTranstation); return; } $.getJSON(`/lib/translation/${locale}.json`) .done(data => { jsonTranstation = data; resolve(data); }) .fail(err => reject(err)); }) } /** * 翻译取值方法,保持原有调用逻辑不变 * @param {string} value 枚举项key * @param {string} ViewModel 所属枚举分组key * @returns {string} 翻译文本 */ const Translation = (value, ViewModel) => { if (jsonTranstation?.[ViewModel]?.[value]) { return jsonTranstation[ViewModel][value]; } return '--'; }
2. 调整Enumerators.js定义逻辑,延迟初始化枚举内容
不要在脚本加载阶段就执行翻译调用、固化枚举值,改成提供独立初始化方法,等翻译资源就绪后再生成带正确翻译的枚举对象:
'use strict' // 先预留枚举全局变量,不做初始化赋值 let EnumToolBar = null; /** * 初始化所有枚举,必须在翻译资源加载完成后调用 */ const initEnums = async () => { // 第一步:等待翻译资源完整加载 await getTranslationJson(); // 第二步:生成带翻译文本的枚举实例 EnumToolBar = { NEW: { text: Translation('New', 'EnumToolBar'), prefixIcon: 'e-add', id: 'NEW' } } }
3. 调整布局页脚本加载顺序,明确执行时序
保证依赖加载的先后逻辑:先加载jQuery依赖库,再加载翻译工具脚本,再加载枚举定义脚本,最后等所有资源初始化完成后再执行业务逻辑:
<html> <head> ... <!-- 优先加载jQuery核心依赖,保证后续脚本可以正常调用$方法 --> <script src="~/lib/jquery/dist/jquery.min.js"></script> <!-- 加载翻译工具脚本 --> <script src="~/js/ViewModels/Helpers/Translation.js"></script> <!-- 加载枚举定义脚本 --> <script src="~/js/ViewModels/Helpers/Enumerators.js"></script> ... </head> <body> ... <script> // DOM加载完成后,按顺序初始化依赖 $(async function() { try { // 先完成翻译加载、枚举初始化 await initEnums(); // 此处执行业务渲染、ViewModel初始化逻辑 console.log(EnumToolBar.NEW.text); // 可正确获取到"New Value" } catch (err) { console.error('翻译资源加载失败,已使用兜底值', err); } }) </script> </body> </html>
小体量文件的简化优化
如果翻译JSON文件体积很小(小于10KB),可以改成同步阻塞加载模式,无需修改业务代码的异步逻辑:
注意:同步XHR请求会阻塞页面渲染,文件体积较大时不建议使用,避免页面白屏
// 替换Translation.js中的异步加载逻辑,同步拉取翻译文件 const loadTranslationSync = (locale = 'en-EN') => { if (jsonTranstation) return; $.ajax({ url: `/lib/translation/${locale}.json`, async: false, // 关闭异步,请求完成后再执行后续脚本 dataType: 'json', success: data => { jsonTranstation = data; } }) } // 脚本加载阶段立刻执行同步拉取,不等DOM就绪 loadTranslationSync();
内容的提问来源于stack exchange,提问作者João Ribeiro
相关产品推荐
相关产品推荐

