本文介绍如何利用jQuery i18n.properties插件实现Web页面的中英文国际化。通过配置common.properties资源文件,结合jQuery.cookie读取用户语言偏好,动态加载easyui语言包,实现页面元素及UI组件的多语言切换功能。
引入i18n插件与核心JS文件
页面所引用的插件库
<script type="text/JavaScript" src="${path}/plugings/jQuery-easyui/jquery.easyui.min.js"></script>
<script type="text/javascript" src="${path}/js/jquery.i18n.properties.min.js"></script>
以下展示页面引用的JavaScript代码
配置语言类型与获取用户语言偏好
/**
* 设置语言类型: 默认为中文
*/
var i18nLanguage = "zh-CN";
/*
设置一下网站支持的语言种类
zh-CN(中文简体)、en(英语)
*/
var webLanguage = ['zh-CN', 'en'];
//获取网站语言
function getWebLanguage(){
//1.cookie是否存在
if (jQuery.cookie("userLanguage")) {
i18nLanguage = jQuery.cookie("userLanguage");
console.log("language cookie is "+i18nLanguage);
} else {
//2.1 获取用户设置的浏览器语言
var navLanguage = getNavLanguage();
console.log("user set browser language is "+navLanguage);
if (navLanguage) {
// 判断是否在网站支持语言数组里
var charSize = $.inArray(navLanguage, webLanguage);
if (charSize > -1) {
i18nLanguage = navLanguage;
// 存到缓存中
jQuery.cookie("userLanguage ",navLanguage, {
expires : 7
});
};
} else{
console.log("not navigator");
return false;
}
}
}
动态加载EasyUI语言包
//国际化easyui中英文包
function changeEasyuiLanguage(languageName) {
// when login in China the language=zh-CN
var src =$.contextPath+"/plugings/jquery-easyui/locale/easyui-lang-"+languageName.replace('-','_')+".js";
console.log(src);
$.getScript(src);
};
执行页面国际化翻译逻辑
/**
* 执行页面i18n方法
* @return
* @author LH
*/
var execI18n = function(){
//获取网站语言(i18nLanguage,默认为中文简体)
getWebLanguage();
//国际化页面
jQuery.i18n.properties({
name : "common", //资源文件名称
path : $.contextPath+"/i18n/"+i18nLanguage+"/", //资源文件路径
mode : 'map', //用Map的方式使用资源文件中的值
language : i18nLanguage,
cache:false, //指定浏览器是否对资源文件进行缓存,默认false
encoding: 'UTF-8', //加载资源文件时使用的编码。默认为 UTF-8。
callback : function() {//加载成功后设置显示内容
//以下是将要国际化的文字内容
//退出
$("#logOut").html($.i18n.prop('logOut'));
//用户
$("#loginUser").html($.i18n.prop('loginUser'))
}
});
}
页面加载时的初始化流程
/*页面执行加载执行*/
$(function(){
/*执行I18n翻译*/
execI18n();
console.log("网站语言: "+i18nLanguage);
//国际化easyui
changeEasyuiLanguage(i18nLanguage);
});
配置国际化资源文件路径与规范
国际化资源文件的存储路径,其中zh-CN代表简体中文;en代表英语;如需支持其他语言,只需在i18n目录下添加相应文件即可;key需与value一一对应,value为对应语言的文字内容

中文版本的common.properties文件具体内容
中文资源文件内容示例
login.userName=Username
login.passWord=Password
login.sub=Login
login.reset=Reset
login.anonymous=Anonymous
英文版本的common.properties文件具体内容
英文资源文件内容示例
login.userName=Username
login.passWord=Password
login.sub=Login
login.reset=Reset
login.anonymous=Anonymous
以上内容为本文的全部介绍,旨在为读者的学习提供协助,同时也恳请读者多多支持本站