前端国际化

前言

从10年接触编程就开始接触国际化这个概念,然而这些年全面用到国际化的项目并不是很多,且都是些螺丝钉式的工作。15年末,部门项目需要推国际化,前端这块由我来主导。虽然难度不高,但还是拿出来分享下。

选择方式:

目前了解到的前端国际化有以下两种方式:

1、按语言种类分别开发前端界面:

这种方式貌似给人一种很low的感觉且觉着文件会无限多。然而在一般项目中语言种类并不会特别多,实现中英文两种即可满足大部分需求;并且这种方式如果配合上不同的网站风格,不但可以解决中英文字符长度差异问题,而且可以兼顾不同群体的视觉感观。但该方式后期维护中需要付出相当于维护语言种类相同倍数的前端代码;

2、使用配置文件:

使用一套界面,同样的样式文件,调用相对应的语言文件进行DOM渲染。该方式可以快速实现,且只需维护一套前端文件。单页应用建议使用该方法。

如还有更好的方式,希望可以发出来学习下。

我的选择:登陆,注册等单独存在于系统外围的功能模块使用第一种方式,其它主体功能选择的是第二种方式。

第一种方式只需要按语言分类成多份文件,这里就直接跳过。单说第二种方式,该如何实现。

实现步骤:

步骤一:准备语言资源文件

原则上需要遵守一个界面对应一个资源文件,再通过一个统一入口文件进行资源整合。举个栗子:

page1对应的资源文件

var page1 = {
title:{
'zh-cn':'标题',
'en-us':'title'
}
}

page2对应的资源文件

var page2 = {
words:{
'zh-cn':'{0}共有{1}人使用',
'en-us':'{1} people use {0}'
}
}

整合文件

var i18nData = {
page1:page1,
page2:page2,
}

步骤二:引入主JS

自已实现了一个I18N对象,少码字多贴代码,直接上code~

var I18N = {
    /*
    *   @存储语言数据
    * */
    DATA : LD
    /*
    *   @ 使用的语言
    * */
    ,language: 'zh-cn'
    /*
    *   @ 修改使用的语言
    * */
    ,setLanguage: function(language){
        this.language = language;
    }
    /*
     *   @解析string 语言标记  用于解析html中的{{i18n-}}
     *   str:html string
     *   pageName:页面名称 、
     * */
    ,parse: function(str, pageName){
        var _this = this;
        if(!pageName){
            console.error('I18N解析失败,原因pageName='+pageName);
            return;
        }
        if(!_this.language){
            console.error('I18N解析失败,原因language='+_this.language);
            return;
        }
        var key= '',
        parseStr = '';
        parseStr = str.replace(/{{i18n-(.+?)}}/g, function(t){
            key = t.slice(7, t.length - 2);
            try{
                return _this.DATA[pageName][key][_this.language] || '';
            }catch (e){
                console.warn(pageName + '未找到与'+ key +'相匹配的'+ _this.language +'语言');
                return '';
            }
        });
        return parseStr;
    }
    /*
    *   生成所需的文本信息 适用于js内部更改DOM时使用
     *   pageName:页面名称
     *   key: 指向的文本索引
     *   v1,v2,v3:可为空,字符串格式,只存在v1时可为数组
    * */
    ,getText: function(pageName, key, v1, v2, v3){
        var _this = this;
        var intrusion = [];
        //处理参数,实现多态化
        if(arguments.length == 3 && typeof(arguments[2]) == 'object'){
            intrusion = arguments[2];
        }
        else if(arguments.length > 2){
            for(var i=2; i< arguments.length; i++){
            intrusion.push(arguments[i]);
            }
        }
        var _lg = '';
        try{
            _lg = _this.DATA[pageName][key][_this.language] || '';
            if(!intrusion || intrusion.length == 0){
                return _lg;
            }
            _lg = _lg.replace(/{d+}/g, function( word ){
                return intrusion[word.match(/d+/)];
            });
            return _lg;
        }catch (e){
            console.warn('未找到与'+ key +'相匹配的'+ _this.language +'语言');
            return '';
        }
    }
};

主程序加上注释也仅仅70行,很简易。

步骤三:替换文本

配置使用的语言种类:

I18N.setLanguage('en-us');   //设置当前使用的语言为美式英语

替换HTML文本:

首先需要将HTML中原文本更换为{{i18n-*}}格式的标记,举个栗子:

//格式上在借鉴angularjs双向绑定的同时附加特定的标识
<span>标题</span> 替换为 <span>{{i18n-title}}</span>

然后在获取到这段HTML的string格式文件后进行匹配,举个栗子:

//这里直接用jQuery的get方式进行示例
//假设test.html可包含的文本为:<span>{{i18n-title}}</span>
//语言资源文件使用步骤一示例的数据
$.get(‘test.html’, function(htmlSrc){
       var html =  I18N.parse(htmlSrc, 'page1');
       console.log(html);  //将输出<span>title</span>
       $('body').html(html);
});

替换JS中的文本:

用于拼接字符串时处理含文本的字符,简单的举个栗子:

//调用方法:getText(pageName, key, v1, v2, v3) 参数v1,v2,v3用于处理动态数据,可为空,字符串格式,只存在v1时可为数组
var _src = '<span>'
  + I18N.getText('page2', 'title', ['listManager.js', '10'])
  +'</span>';
console.log(_src ); //将输出 10 people use listManager.js

@拭目以待

表格管理插件:gridmanager.lovejavascript.com && github地址
QQ交流群 (452781895):How To Make Love

《野生前端工程师》专辑中所有文章均为@拭目以待 原创,转载请注明出处。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,590评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 86,808评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,151评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,779评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,773评论 5 367
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,656评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,022评论 3 398
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,678评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,038评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,659评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,756评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,411评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,005评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,973评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,053评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,495评论 2 343

推荐阅读更多精彩内容