渲染插件

数据渲染器可用来将源中某个格式的数据转换为另一种格式。如果你希望自定义用户看到的数据,这会很有用,比如用百分比条显示数字。

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, $);

插件