檢測瀏覽器語言
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>
多語言最佳實踐總結
- 檢測優先級:
navigator.languages[0] > navigator.language > navigator.browserLanguage (IE) > 默認 en-US
- 語言代碼標準化:統一用
BCP 47 (如 zh-CN),加載時轉換為文件命名格式 (zh_CN)
- 異步加載 + 回退:動態
<script>,onerror 回退英文
- 避免阻塞渲染:語言包放
<head> 異步加載,或構建時內聯
- 應用層 i18n:EasyUI 只負責組件提示,業務文案需獨立 i18n 方案 (如
i18next, vue-i18n)