国际化插件
展示层的本地化对任何软件包都很重要,我的目标是让这项通常艰巨的任务在 DataTables 中变得尽可能容易。为此,一些贡献者已将 DataTables 中使用的语言字符串翻译成各种不同的语言。如果您将 DataTables 翻译成任何其他语言,请联系我或发送GitHub 请求拉取。
如何使用
在 DataTables 中,有两种初始化方法,您可以通过它们在 DataTables 中包含国际化选项
- 通过 Ajax 请求加载语言文件 (
language.url
) - 在初始化时使用
language
属性。
您加载翻译文件的方式将取决于您如何加载 DataTables。如果您在浏览器中进行加载,请使用 .json
文件并设置 language.url
选项。如果您使用 ESM 或 CommonJS,通常会使用 language
选项。
浏览器
在浏览器中直接加载 DataTables 的语言信息是使用 .json
文件完成的 - 例如
var table = new DataTable('#myTable', {
language: {
url: 'dataTables.german.json',
},
});
ES 模块
当使用 ES 模块(例如使用 Vite 或类似的打包器时),您可以使用 datatables.net-plugins
包(.mjs
文件)并从那里包含翻译
import DataTable from 'datatables.net';
import languageDE from 'datatables.net-plugins/i18n/de-DE.mjs';
var table = new DataTable('#myTable', {
language: languageDE,
});
CommonJS
如果您使用 CommonJS(即在较旧版本的 Node 或 Webpack 中),则可以加载 .js
文件,CommonJS 加载程序将返回翻译的 JSON 结构(请注意,与其他 DataTables 插件不同,它不返回要执行的函数 - 只是 JSON 对象)
var $ = require('jquery');
var DataTable = require('datatables.net')(window, $);
var languageDE = require('datatables.net-plugins/i18n/de-DE.js');
var table = new DataTable('#myTable', {
language: languageDE,
});