最佳实践javascript和多语言

时间:2008-10-23 07:21:17

标签: javascript internationalization

多语言网站使用DOM操作javascript的最佳做法是什么?我使用javascript构建了一些网站的动态部分。我的第一个想法是使用带有文本字符串和语言代码的数组作为索引。这是个好主意吗?

10 个答案:

答案 0 :(得分:69)

当我之前构建多语言网站(不是非常大的网站,所以这可能无法扩展得太好)时,我会保留一系列“语言”文件:

  • lang.en.js
  • lang.it.js
  • lang.fr.js

每个文件都声明一个对象,该对象基本上只是从关键词到语言短语的映射:

// lang.en.js
lang = {
    greeting : "Hello"
};

// lang.fr.js
lang = {
    greeting : "Bonjour"
};

动态加载其中一个文件,然后您需要做的就是从地图中引用该键:

document.onload = function() {
    alert(lang.greeting);
};

当然,有很多其他方法可以做到这一点,并且有很多方法可以做到这种风格但更好:将它全部封装到一个函数中,以便可以优雅地处理“字典”中缺少的短语,甚至可以整个事情使用OOP,让它管理文件的动态包括,它甚至可能为你绘制语言选择器等。

var l = new Language('en');
l.get('greeting');

答案 1 :(得分:49)

在设计多语言支持时,您需要记住以下几点:

1 - 将数据与数据分开(即不要将字符串硬编码到函数中)

2 - 创建一个格式化钩子函数来处理本地化差异。允许格式化字符串(“{0}”)优于连接(“欢迎使用”+值),原因如下:

  • 在某些语言中,数字格式为1.234.678,00而不是1,234,567.00
  • 复数通常不像在单数末尾附加“s”那么简单
  • 语法规则不同,可能会影响事物的顺序,因此您应该允许在翻译钩子后添加动态数据:例如,“欢迎使用{0}”变成日语中的“{0}他youkoso”(这种情况几乎发生在所有语言中,请注意)。

3 - 确保您可以在转换挂钩运行后实际格式化字符串,这样您就可以重复使用键。

4 - 在任何情况下,不要将数据库输出挂钩到翻译器实用程序。如果您有多语言数据,请在数据库中创建单独的表/行。我已经看到人们经常犯这样的错误(通常是表格中的国家和州/省)。

5 - 创建用于创建密钥的显式编码实践规则。格式化程序实用程序功能(看起来像 translate(“hello world”)会将一个键作为参数,而稍微变化的键会使维护非常烦人。例如,您最终可能会遇到这种情况。以下示例中的三个键:“输入您的名字”,“输入您的姓名:”,“输入您的姓名:”。选择一种格式(例如,没有冒号,修剪)并捕获代码评论中的差异。不要进行此过滤以编程方式,因为它可以触发误报。

6 - 请注意,翻译表中可能需要HTML标记(例如,如果您需要在句子中加粗单词,或者有脚注医学参考)。对此进行了广泛的测试。

7 - 有几种导入语言字符串的方法。理想情况下,您应该有一个language.lang.js文件的多个版本,使用服务器端代码在它们之间切换,并从HTML文件的底部引用该文件。通过AJAX拉取文件也是一种替代方案,但可能会引入延迟。不建议将language.js合并到主代码文件中,因为您将失去文件缓存的好处。

8 - 用您的目标语言进行测试。这听起来很傻,但我曾经看过一个严重的错误,因为程序员没有费心去检查密钥中是否存在“é”

答案 2 :(得分:12)

function Language(lang)
{
    var __construct = function() {
        if (eval('typeof ' + lang) == 'undefined')
        {
            lang = "en";
        }
        return;
    }()

    this.getStr = function(str, defaultStr) {
        var retStr = eval('eval(lang).' + str);
        if (typeof retStr != 'undefined')
        {
            return retStr;
        } else {
            if (typeof defaultStr != 'undefined')
            {
                return defaultStr;
            } else {
                return eval('en.' + str);
            }
        }
    }
}

将此内容添加到您的页面后,您可以像这样使用它:

var en = {
    SelPlace:"Select this place?",
    Save:"Saved."
};

var tr = {
    SelPlace:"Burayı seçmek istiyor musunuz?"
};

var translator = new Language("en");
alert(translator.getStr("SelPlace")); // result: Select this place?
alert(translator.getStr("Save")); // result: Saved.
alert(translator.getStr("DFKASFASDFJK", "Default string for non-existent string")); // result: Default string for non-existent string

var translator = new Language("tr");
alert(translator.getStr("SelPlace")); // result: Burayı seçmek istiyor musunuz?
alert(translator.getStr("Save")); // result: Saved. (because it doesn't exist in this language, borrowed from english as default)
alert(translator.getStr("DFKASFASDFJK", "Default string for non-existent string")); // result: Default string for non-existent string

如果您使用您尚未定义的语言致电课程,则会选择英语( en )。

答案 3 :(得分:5)

刚刚在javascript中发现了一篇关于i18n的好文章:
http://24ways.org/2007/javascript-internationalisation

虽然使用i18n + javascript的简单谷歌搜索显示了很多替代方案。

最后,这取决于您希望它的深度。对于几种语言,单个文件就足够了。

您可以使用Jquery之类的框架,使用范围来标识文本(带有类),然后使用每个范围的ID来查找所选语言的相应文本。
完成了1行Jquery。

答案 4 :(得分:5)

在阅读了nickf和Leo的精彩答案后,我创建了以下CommonJS样式language.js来管理我的所有字符串(以及可选的Mustache来格式化它们):

var Mustache = require('mustache');

var LANGUAGE = {
    general: {
        welcome: "Welcome {{name}}!"
    }
};

function _get_string(key) {
    var parts = key.split('.');
    var result = LANGUAGE, i;
    for (i = 0; i < parts.length; ++i) {
        result = result[parts[i]];
    }
    return result;
}

module.exports = function(key, params) {
    var str = _get_string(key);
    if (!params || _.isEmpty(params)) {
        return str;
    }
    return Mustache.render(str, params);
};

这就是我得到一个字符串的方式:

var L = require('language');
var the_string = L('general.welcome', {name='Joe'});

答案 5 :(得分:1)

你应该看一下经典JS组件中做了些什么 - 比如Dojo,Ext,FCKEditor,TinyMCE等。你会发现很多好主意。

通常它最终会成为您在标签上设置的某种属性,然后根据属性的值将翻译文件中的翻译内容替换为翻译文件中的翻译。

要记住的一件事是语言集的演变(当你的代码发展时,你需要重新翻译整个事物)。我们将翻译保存在PO文件(Gnu Gettext)中,我们有一个脚本可以将PO文件转换为可以使用的JS文件。

另外:

  • 总是使用UTF-8 - 这听起来很愚蠢,但如果你从一开始就没有使用utf-8(HTML头+ JS编码),你就会很快崩溃。
  • 使用英语字符串作为翻译的关键 - 这样你就不会得到类似的东西:lang.Greeting ='Hello world' - 但lang ['Hello world'] ='Hello world'; < / LI>

答案 6 :(得分:1)

您可以使用Google翻译:

<div id="google_translate_element" style = "float: left; margin-left: 10px;"></div>

<script type="text/javascript">
function googleTranslateElementInit() {
  new google.translate.TranslateElement({pageLanguage: 'en', layout: google.translate.TranslateElement.InlineLayout.HORIZONTAL}, 'google_translate_element');
}
</script>

<script type="text/javascript" src="//translate.google.com/translate_a/element.js?cb=googleTranslateElementInit"></script>

</div><input type = "text" style = "display: inline; margin-left: 8%;" class = "sear" placeholder = "Search people..."><button class = "bar">&#128270;</button>

答案 7 :(得分:0)

对于Spring bundle和JavaScript,有一个简单的解决方案:在模板中生成i18n数组(例如JSP)并在JavaScript中使用它:

JSP:

<html>
<script type="text/javascript">
    var i18n = [];
    <c:forEach var='key' items='<%=new String[]{"common.deleted","common.saved","common.enabled","common.disabled","...}%>'>
        i18n['${key}'] = '<spring:message code="${key}"/>';
    </c:forEach>
</script>
</html>

在JS中:

alert(i18n["common.deleted"]);

另见Resolving spring:messages in javascript for i18n internationalization

答案 8 :(得分:0)

这样,您可以通过多个单词将一个js代码用于多语言:

var strings = new Object();

if(navigator.browserLanguage){
  lang = navigator.browserLanguage;
}else{
  lang = navigator.language;
}

lang = lang.substr(0,2).toLowerCase();



if(lang=='fa'){/////////////////////////////Persian////////////////////////////////////////////////////


        strings["Contents"]                              = "فهرست";
        strings["Index"]                                 = "شاخص";
        strings["Search"]                                = "جستجو";
        strings["Bookmark"]                              = "ذخیره";

        strings["Loading the data for search..."]        = "در حال جسنجوی متن...";
        strings["Type in the word(s) to search for:"]    = "لغت مد نظر خود را اینجا تایپ کنید:";
        strings["Search title only"]                     = "جستجو بر اساس عنوان";
        strings["Search previous results"]               = "جستجو در نتایج قبلی";
        strings["Display"]                               = "نمایش";
        strings["No topics found!"]                      = "موردی یافت نشد!";

        strings["Type in the keyword to find:"]          = "کلیدواژه برای یافتن تایپ کنید";

        strings["Show all"]                              = "نمایش همه";
        strings["Hide all"]                              = "پنهان کردن";
        strings["Previous"]                              = "قبلی";
        strings["Next"]                                  = "بعدی";

        strings["Loading table of contents..."]          = "در حال بارگزاری جدول فهرست...";

        strings["Topics:"]                               = "عنوان ها";
        strings["Current topic:"]                        = "عنوان جاری:";
        strings["Remove"]                                = "پاک کردن";
        strings["Add"]                                   = "افزودن";

}else{//////////////////////////////////////English///////////////////////////////////////////////////

strings["Contents"]                              = "Contents";
strings["Index"]                                 = "Index";
strings["Search"]                                = "Search";
strings["Bookmark"]                              = "Bookmark";

strings["Loading the data for search..."]        = "Loading the data for search...";
strings["Type in the word(s) to search for:"]    = "Type in the word(s) to search for:";
strings["Search title only"]                     = "Search title only";
strings["Search previous results"]               = "Search previous results";
strings["Display"]                               = "Display";
strings["No topics found!"]                      = "No topics found!";

strings["Type in the keyword to find:"]          = "Type in the keyword to find:";

strings["Show all"]                              = "Show all";
strings["Hide all"]                              = "Hide all";
strings["Previous"]                              = "Previous";
strings["Next"]                                  = "Next";

strings["Loading table of contents..."]          = "Loading table of contents...";

strings["Topics:"]                               = "Topics:";
strings["Current topic:"]                        = "Current topic:";
strings["Remove"]                                = "Remove";
strings["Add"]                                   = "Add";

}

您可以在此代码中添加另一个lang并在html代码上设置对象。

答案 9 :(得分:0)

class Language {
    constructor(lang) {
        var __construct = function (){
            if (eval('typeof ' + lang) == 'undefined'){
                lang = "en";
            }
            return;
        };
        this.getStr = function (str){
            var retStr = eval('eval(lang).' + str);
            if (typeof retStr != 'undefined'){
                return retStr;
            } else {
                return str;
            }
        };
    }
}

var en = {
    Save:"Saved."
};

var fa = {
    Save:"ذخیره"
};

var translator = new Language("fa");
console.log(translator.getStr("Save"));