当前位置：首页 > 文章列表 > 文章 > 前端 > DataTables自定义分页设置教程

DataTables自定义分页设置教程

2025-10-07 17:09:33 0浏览收藏

想自定义 DataTables 表格的分页大小吗？本教程为你详细讲解如何使用 DataTables 的 `lengthMenu` 选项，轻松实现自定义分页条目数，例如将默认的10, 25, 50, 100修改为15, 30, 50，甚至添加“所有”选项，让用户自由选择每页显示的数据量。通过示例代码，你将学会如何配置 `lengthMenu` 数组，包括数值和对应的显示文本，从而优化表格的数据呈现方式，显著提升用户体验。了解 DataTables 自定义分页，让你的表格更具灵活性和实用性！解决大数据量表格展示难题，快来学习吧！

DataTables 分页大小定制指南：如何自定义每页显示条目数

本教程详细指导如何在 DataTables 中自定义分页大小选项，将默认的每页显示条目数（如10, 25, 50, 100）更改为用户指定的数值，并支持显示所有条目。通过配置 lengthMenu 选项，开发者可以灵活控制表格的数据呈现方式，提升用户体验。

理解 DataTables 的分页机制

DataTables 提供了一个内置的下拉菜单，允许用户选择每页显示的数据条目数。默认情况下，这些选项通常是10、25、50和100。然而，在许多应用场景中，开发者需要根据实际需求提供自定义的选项，例如15、30、50，甚至是一个显示所有条目的选项。DataTables 通过 lengthMenu 配置项提供了这种灵活性。

使用 lengthMenu 自定义分页选项

lengthMenu 选项是一个数组，它接受两种形式的参数：

纯数字数组： [10, 25, 50, -1]，其中 -1 代表“所有”条目。
嵌套数组： [[10, 25, 50, -1], [10, 25, 50, "All"]]。第一个子数组定义了实际的数值，第二个子数组定义了在下拉菜单中显示的文本标签。

要将分页大小更改为 15, 30, 50 和 "所有"，我们需要使用嵌套数组的形式来同时定义数值和对应的显示文本。

示例代码：集成自定义分页选项

假设您已有一个 DataTables 实例，并已配置了页脚搜索功能，如下所示：

<!DOCTYPE html>
<html>
<head>
    <title>DataTables 自定义分页大小</title>
    <link rel="stylesheet" type="text/css" href="https://cdn.datatables.net/1.10.25/css/jquery.dataTables.min.css">
    <script type="text/javascript" charset="utf8" src="https://code.jquery.com/jquery-3.5.1.js"></script>
    <script type="text/javascript" charset="utf8" src="https://cdn.datatables.net/1.10.25/js/jquery.dataTables.min.js"></script>
</head>
<body>

<table id="example" class="display" style="width:100%">
    <thead>
        <tr>
            <th>Name</th>
            <th>Position</th>
            <th>Office</th>
            <th>Age</th>
            <th>Start date</th>
            <th>Salary</th>
        </tr>
    </thead>
    <tbody>
        <tr><td>Tiger Nixon</td><td>System Architect</td><td>Edinburgh</td><td>61</td><td>2011/04/25</td><td>$320,800</td></tr>
        <tr><td>Garrett Winters</td><td>Accountant</td><td>Tokyo</td><td>63</td><td>2011/07/25</td><td>$170,750</td></tr>
        <tr><td>Ashton Cox</td><td>Junior Technical Author</td><td>San Francisco</td><td>66</td><td>2009/01/12</td><td>$86,000</td></tr>
        <tr><td>Cedric Kelly</td><td>Senior Javascript Developer</td><td>Edinburgh</td><td>22</td><td>2012/03/29</td><td>$433,060</td></tr>
        <tr><td>Airi Satou</td><td>Accountant</td><td>Tokyo</td><td>33</td><td>2008/11/28</td><td>$162,700</td></tr>
        <tr><td>Brielle Williamson</td><td>Integration Specialist</td><td>New York</td><td>61</td><td>2012/12/02</td><td>$372,000</td></tr>
        <tr><td>Herrod Chandler</td><td>Sales Assistant</td><td>San Francisco</td><td>59</td><td>2012/08/06</td><td>$137,500</td></tr>
        <tr><td>Rhona Davidson</td><td>Integration Specialist</td><td>Tokyo</td><td>55</td><td>2010/10/14</td><td>$327,900</td></tr>
        <tr><td>Colleen Hurst</td><td>Javascript Developer</td><td>San Francisco</td><td>39</td><td>2009/09/15</td><td>$205,500</td></tr>
        <tr><td>Sonya Frost</td><td>Software Engineer</td><td>Edinburgh</td><td>23</td><td>2008/12/13</td><td>$103,600</td></tr>
        <tr><td>Jena Gaines</td><td>Office Manager</td><td>London</td><td>30</td><td>2008/12/19</td><td>$90,560</td></tr>
        <tr><td>Quinn Flynn</td><td>Support Engineer</td><td>Edinburgh</td><td>22</td><td>2013/03/03</td><td>$342,000</td></tr>
        <tr><td>Charde Marshall</td><td>Regional Director</td><td>San Francisco</td><td>36</td><td>2008/10/16</td><td>$470,600</td></tr>
        <tr><td>Haley Kennedy</td><td>Senior Marketing Designer</td><td>London</td><td>43</td><td>2012/12/18</td><td>$313,500</td></tr>
        <tr><td>Tatyana Fitzpatrick</td><td>Regional Director</td><td>London</td><td>19</td><td>2010/03/17</td><td>$385,750</td></tr>
        <tr><td>Michael Silva</td><td>Marketing Designer</td><td>London</td><td>66</td><td>2012/11/27</td><td>$198,500</td></tr>
        <tr><td>Paul Byrd</td><td>Chief Financial Officer (CFO)</td><td>New York</td><td>64</td><td>2010/06/09</td><td>$725,000</td></tr>
        <tr><td>Gloria Little</td><td>Systems Administrator</td><td>New York</td><td>59</td><td>2009/04/10</td><td>$237,500</td></tr>
        <tr><td>Bradley Greer</td><td>Software Engineer</td><td>London</td><td>41</td><td>2012/10/13</td><td>$132,000</td></tr>
        <tr><td>Dai Rios</td><td>Personnel Lead</td><td>Edinburgh</td><td>35</td><td>2012/09/26</td><td>$217,500</td></tr>
        <tr><td>Jenette Caldwell</td><td>Development Lead</td><td>New York</td><td>30</td><td>2011/09/03</td><td>$345,000</td></tr>
        <tr><td>Yuri Berry</td><td>Chief Marketing Officer (CMO)</td><td>New York</td><td>40</td><td>2009/06/25</td><td>$675,000</td></tr>
        <tr><td>Caesar Vance</td><td>Pre-Sales Support</td><td>New York</td><td>21</td><td>2011/12/12</td><td>$106,450</td></tr>
        <tr><td>Doris Wilder</td><td>Sales Assistant</td><td>Sydney</td><td>23</td><td>2009/09/20</td><td>$85,600</td></tr>
        <tr><td>Angelica Ramos</td><td>Chief Executive Officer (CEO)</td><td>London</td><td>47</td><td>2009/10/09</td><td>$1,200,000</td></tr>
        <tr><td>Gavin Joyce</td><td>Developer</td><td>Edinburgh</td><td>42</td><td>2010/12/22</td><td>$92,575</td></tr>
        <tr><td>Jennifer Chang</td><td>Regional Director</td><td>Singapore</td><td>28</td><td>2010/11/14</td><td>$357,650</td></tr>
        <tr><td>Brenden Wagner</td><td>Software Engineer</td><td>San Francisco</td><td>28</td><td>2011/06/07</td><td>$206,850</td></tr>
        <tr><td>Fiona Green</td><td>Chief Operating Officer (COO)</td><td>San Francisco</td><td>48</td><td>2010/03/11</td><td>$850,000</td></tr>
        <tr><td>Shad Decker</td><td>Regional Director</td><td>Edinburgh</td><td>51</td><td>2008/11/13</td><td>$183,000</td></tr>
    </tbody>
    <tfoot>
        <tr>
            <th>Name</th>
            <th>Position</th>
            <th>Office</th>
            <th>Age</th>
            <th>Start date</th>
            <th>Salary</th>
        </tr>
    </tfoot>
</table>

<script type="text/javascript">
  $(document).ready(function() {
    // Setup - add a text input to each footer cell
    $('#example tfoot th').each( function () {
        var title = $(this).text();
        $(this).html( '&lt;input type=&quot;text&quot; placeholder=&quot;搜索 &apos;+title+&apos;&quot; /&gt;' ); // 更改placeholder文本
    } );

    // DataTable 初始化
    var table = $('#example').DataTable({
        // 在这里添加 lengthMenu 配置
        "lengthMenu": [[15, 30, 50, -1], [15, 30, 50, "所有"]],
        initComplete: function () {
            // Apply the search
            this.api().columns().every( function () {
                var that = this;

                $( 'input', this.footer() ).on( 'keyup change clear', function () {
                    if ( that.search() !== this.value ) {
                        that
                            .search( this.value )
                            .draw();
                    }
                } );
            } );
        }
    });
  } );
</script>

</body>
</html>

在上面的代码中，关键的修改是 DataTable 初始化对象中的 lengthMenu 属性：

"lengthMenu": [[15, 30, 50, -1], [15, 30, 50, "所有"]]

[15, 30, 50, -1]：这个子数组定义了实际的每页显示条目数值。-1 是 DataTables 的一个特殊值，表示显示所有条目。
[15, 30, 50, "所有"]：这个子数组定义了在下拉菜单中与上述数值对应的显示文本。例如，当选择 -1 时，下拉菜单中会显示 "所有"。

通过这种方式，DataTables 会渲染一个包含 "15", "30", "50", "所有" 选项的下拉菜单，让用户可以灵活选择每页显示的条目数。

注意事项

性能影响： 当表格数据量非常大时，选择 "所有" 条目可能会导致浏览器性能下降，因为所有数据都需要一次性加载到 DOM 中。在设计时应考虑这一点，并权衡用户体验和性能。
默认选中项： lengthMenu 仅仅是定义了可用的选项。要设置 DataTables 初始时每页显示的条目数，您需要使用 pageLength 选项。例如，"pageLength": 30 会在初始化时默认显示 30 条数据。
国际化： 如果您的应用需要支持多语言，"所有" 这样的文本也应该通过 DataTables 的国际化配置进行管理，而不是硬编码。例如，可以使用 language.lengthMenu 选项。
与其他选项的兼容性： lengthMenu 选项与 DataTables 的其他核心功能（如搜索、排序、分页等）完全兼容，可以无缝集成。