國際化外掛
對於任何軟體套件來說,呈現層的本地化都是非常重要的,而我的目標是讓 DataTables 中這個通常繁瑣的任務盡可能地簡單。為此,許多貢獻者好心地將 DataTables 中使用的語言字串翻譯成各種不同的語言。如果您將 DataTables 翻譯成任何其他語言,請聯絡我們或發送一個 Github pull request。
如何使用
在 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,
});