You need to enable JavaScript to run this app. 布局页中如何保障翻译JSON资源加载完成后再执行依赖翻译的脚本
优惠活动
大模型
产品
解决方案
定价
更多

布局页中如何保障翻译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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 23:54:04