国际化 Internationalisation


Datatables增强表格功能后,会在表格的周围添加多个控件,这些控件使用了语言字符的方式将用法或意思传达给最终用户。这些语言字符默认是英语,你也可以自定义以适合自己项目的实际情况来表达这些意思。

配置(Configuration)


通过 languageOption 选项配置Datatables使用的语言。这是一个对象,其参数描述了Datatables每个部分使用的字符串。语言选项的完整列表在配置选项文档中查看。

常规配置(Normal configuration)


作为初始化对象的一部分,语言选项的配置与Datatables中的其他配置选项完全相同。下面的例子演示了如何改变搜索字符串:

$('#example').DataTable( {
    language: {
        search: "在表格中搜索:"
    }
} );

与其他初始化选项一样,你可以根据你的需要使用任意数量的的选项。那些你没有提供的值将会用默认值替代。下面实例演示了用中文显示Datatables中的每个控件和提示信息:

$('#example').DataTable( {
    language:{
        "processing": "处理中...",
        "lengthMenu": "显示 _MENU_ 项结果",
        "zeroRecords": "没有匹配结果",
        "info": "显示第 _START_ 至 _END_ 项结果,共 _TOTAL_ 项",
        "infoEmpty": "显示第 0 至 0 项结果,共 0 项",
        "infoFiltered": "(由 _MAX_ 项结果过滤)",
        "infoPostFix": "",
        "search": "搜索:",
        "searchPlaceholder": "搜索...",
        "url": "",
        "emptyTable": "表中数据为空",
        "loadingRecords": "载入中...",
        "infoThousands": ",",
        "paginate": {
            "first": "首页",
            "previous": "上页",
            "next": "下页",
            "last": "末页"
        },
        "aria": {
            "paginate": {
                "first": "首页",
                "previous": "上页",
                "next": "下页",
                "last": "末页"
            },
            "sortAscending": "以升序排列此列",
            "sortDescending": "以降序排列此列"
        },
        "thousands": "."
    }
} );

Ajax加载语言(Ajax loading a translation)


为了方便起见,Datatables提供了通过Ajax从远程文件加载语言信息的选项。这是通过 language.urlOption 选项配置的。例如下面的代码示例:

$('#example').DataTable( {
    language: {
        url: '/localisation/zh_CN.json'
    }
} );

language.urlOption 选项配置一样,由Ajax加载的文件可以指定任意数量的语言选项,没有指定的选项将使用Datatables的默认值。

数字数据的排序(Ordering of numeric data)


数字数据通常按照某些规则进行格式化,例如小数点字符,千位分隔符,和数字类标识(例如货币符号)。Datatables会自动检测数字数据类型,例如币种,百分比值和带有千位分隔符的值,但默认情况下,所有这些都使用点.作为小数点,因为这是用JavaScript标识数字的方式。

Datatables可以通过 language.decimalOption 选项将任何字符用作数字数据的小数位,从而提供完整的数字类型检测和任何形式的数字数据的排序。例如,世界上很多地方都使用逗号,作为小数位,Unicode定义小数点分隔符,财务文件有时会用破折号-,等等。

通过使用 language.decimalOption 选项,你可以告诉Datatables寻找什么字符作为表中数据的小数位,因此可以正确地对这些数据进行排序。

如下代码演示如何配置小数位字符,直接配置在初始化代码,或者通过Ajax加载语言配置文件,在配置文件里定义:

$('#example').DataTable( {
    language: {
        decimal: ",",
    }
} );

可用翻译(Available translations)


这里由社区提供了50多种翻译,可供随意使用,从而使Datatables轻松集成到你的项目中去。

https://datatables.net/manual/i18n

Translation from DataTables.net, with permission