萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 檢測瀏覽器語言動態加載 EasyUI 語言包 (i18n 實戰)

檢測瀏覽器語言

function getBrowserLang() {
  // 標準屬性 (現代瀏覽器)
  if (navigator.languages && navigator.languages.length) {
    return navigator.languages[0]; // 首選語言
  }
  // 兼容舊屬性
  return navigator.language || navigator.browserLanguage || navigator.userLanguage || 'en-US';
}

// 使用
var lang = getBrowserLang(); // 如 "zh-CN", "en-US", "ja-JP"
console.log('瀏覽器語言:', lang);

動態加載 EasyUI 語言包

function loadEasyUILocale(lang) {
  // 標準化語言代碼:zh-CN -> zh_CN, zh-TW -> zh_TW
  var localeCode = lang.replace('-', '_');
  
  // EasyUI 語言包路徑規則
  var url = 'jquery-easyui/locale/easyui-lang-' + localeCode + '.js';
  
  // 檢查是否已加載 (避免重複)
  if (document.querySelector('script[src*="easyui-lang-' + localeCode + '"]')) {
    console.log('語言包已加載:', localeCode);
    return;
  }
  
  // 動態創建 script 標籤 (異步非阻塞)
  var script = document.createElement('script');
  script.src = url;
  script.charset = 'utf-8';
  script.onload = function() {
    console.log('EasyUI 語言包加載成功:', localeCode);
    // 可選:觸發自定義事件通知應用
    window.dispatchEvent(new CustomEvent('easyui-locale-loaded', { detail: localeCode }));
  };
  script.onerror = function() {
    console.warn('語言包加載失敗,回退英文:', url);
    // 可選:加載 en_US 作為 fallback
    if (localeCode !== 'en_US') loadEasyUILocale('en-US');
  };
  document.head.appendChild(script);
}

// 自動檢測並加載
var browserLang = getBrowserLang();
if (browserLang.startsWith('zh')) {
  loadEasyUILocale(browserLang); // zh-CN, zh-TW, zh-HK 等
}
// 其他語言按需加載...

完整 HTML 整合範例

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <title>EasyUI i18n Demo</title>
  <link rel="stylesheet" href="jquery-easyui/themes/default/easyui.css">
  <link rel="stylesheet" href="jquery-easyui/themes/icon.css">
  <script src="jquery-easyui/jquery.min.js"></script>
  <script src="jquery-easyui/jquery.easyui.min.js"></script>
  
  <script>
  // 語言檢測與加載 (必須在 easyui.min.js 之後、業務代碼之前)
  (function() {
    function getLang() {
      return navigator.languages?.[0] || navigator.language || navigator.browserLanguage || 'en-US';
    }
    function loadLocale(lang) {
      var code = lang.replace('-', '_');
      var script = document.createElement('script');
      script.src = 'jquery-easyui/locale/easyui-lang-' + code + '.js';
      script.onerror = function() { 
        if (code !== 'en_US') loadLocale('en-US'); 
      };
      document.head.appendChild(script);
    }
    var lang = getLang();
    if (lang !== 'en-US') loadLocale(lang); // 英文為默認內建,無需加載
  })();
  </script>
</head>
<body>
  <table id="dg" title="用戶列表" class="easyui-datagrid" style="width:600px;height:300px"
    data-options="url:'data.json',fitColumns:true,singleSelect:true">
    <thead>
      <tr>
        <th data-options="field:'name',width:100">姓名</th>
        <th data-options="field:'age',width:60,align:'right'">年齡</th>
      </tr>
    </thead>
  </table>
</body>
</html>

進階:構建時內聯語言包 (避免額外請求)

// webpack 配置 (webpack.config.js)
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  plugins: [
    new HtmlWebpackPlugin({
      template: 'index.html',
      templateParameters: {
        // 根據構建目標語言內聯對應語言包
        easyuiLocale: require('raw-loader!jquery-easyui/locale/easyui-lang-zh_CN.js')
      }
    })
  ]
};

// index.html 模板
// <script><%= htmlWebpackPlugin.options.templateParameters.easyuiLocale %></script>

多語言最佳實踐總結

  1. 檢測優先級:navigator.languages[0] > navigator.language > navigator.browserLanguage (IE) > 默認 en-US
  2. 語言代碼標準化:統一用 BCP 47 (如 zh-CN),加載時轉換為文件命名格式 (zh_CN)
  3. 異步加載 + 回退:動態 <script>,onerror 回退英文
  4. 避免阻塞渲染:語言包放 <head> 異步加載,或構建時內聯
  5. 應用層 i18n:EasyUI 只負責組件提示,業務文案需獨立 i18n 方案 (如 i18next, vue-i18n)
copyright © 萬盛學電腦網 all rights reserved