渲染外掛程式

資料渲染器可以用於將資料從一種格式轉換為另一種格式。如果您想要自訂使用者看到的資料,這會很有用 - 例如,針對數字顯示百分比長條圖。

DataTables 有三個內建的渲染器 (datetimenumbertext),可以透過下面的外掛程式進行擴充。也可以根據需要建立更多 - 請參閱這篇部落格文章,以取得建立您自己外掛程式的完整說明。

如何使用

資料渲染外掛程式實際上只是應用於columns.render選項的函式 (請參閱DataTables 渲染器文件以取得更多詳細資訊)。載入後,資料渲染外掛程式會附加到 DataTable.render 物件,然後您會參考該物件以使用columns.render選項。

瀏覽器

在瀏覽器中直接載入資料渲染外掛程式只需要載入外掛程式的 Javascript 即可。例如,下面的程式碼使用儲存在檔案中的 ellipsis 外掛程式

<script type="text/javascript" src="jquery.dataTables.js"></script>
<script type="text/javascript" src="dataTables.ellipsis.js"></script>
<script type="text/javascript">
    var table = new DataTable('#myTable', {
        columnDefs: [
            {
                target: 0,
                render: DataTable.render.ellipsis(),
            },
        ],
    });
</script>

可以在我們的 CDN 上找到可以包含在瀏覽器中的外掛程式。請參閱每個外掛程式的詳細資訊頁面,以取得完整的 CDN URL。

ES 模組

資料渲染器外掛程式也可以作為 ES 模組使用,可以從datatables.net-plugins 套件 (.mjs 檔案) 載入。您需要包含外掛程式所需的檔案。下面我們再次使用 ellipsis 作為範例

import DataTable from 'datatables.net';
import 'datatables.net-plugins/dataRender/ellipsis.mjs';

var table = new DataTable('#myTable', {
    columnDefs: [
        {
            target: 0,
            render: DataTable.render.ellipsis(),
        },
    ],
});

CommonJS

如果您正在使用CommonJS (例如,在舊版本的 Node 或 Webpack 中),則可以載入 .js 檔案,它會自動將外掛程式新增至 DataTables。與 DataTables 核心和擴充功能一樣,CommonJS 載入器提供了一個您需要使用 window$/jQuery 物件呼叫的函式 - 例如。

var $ = require('jquery');
var DataTable = require('datatables.net')(window, $);
require('datatables.net-plugins/dataRender/ellipsis.js')(window, $);

外掛程式