DataTables Part1 -Introduction-

概要

DataTablesとはjQueryを用いたテーブルプラグインの一種。
使用した機能を備忘録を兼ねて掲載。

選んだ理由として、下記機能が標準搭載されており、見た目もすっきりしていることが挙げられる。更にカスタマイズしていくことも可能。

1. インスタント検索(フィルタ機能)
2. ページネーション (ページング処理)
3. ソート機能

基本的にはDataTablesの公式サイトを見れば大概のことは載っている。

 

導入方法

jQueryとDataTablesのライブラリを読み込んで、反映したいTableのid、classを指定すれば基本的な形が出来上がる。idは好きな名前をつければよいが、javascript(datatables_custom.js)内と合わせること。”datatables_custom.js” にはTableをDataTables化するとともに、ここで色々記述することでオリジナル仕様にしていくことができるjQueryを記述する。自分で書いて定義するものなので、新規作成で用意する。

具体的な動きはこちら。DataTablesのバージョンは1.10.15を利用している。


 

<br />
&lt;link rel=&quot;stylesheet&quot; href=&quot;https://cdn.datatables.net/1.10.15/css/jquery.dataTables.min.css&quot;/&gt;<br />
&lt;script src=&quot;https://code.jquery.com/jquery-2.2.4.min.js&quot;&gt;&lt;/script&gt;<br />
&lt;script src=&quot;https://cdn.datatables.net/1.10.15/js/jquery.dataTables.min.js&quot;&gt;&lt;/script&gt;<br />
&lt;script src=&quot;./js/datatables_custom.js&quot;&gt;&lt;/script&gt;<br />

 

<br />
    &lt;table id=&quot;example&quot; class=&quot;display&quot; width=&quot;100%&quot; cellspacing=&quot;0&quot;&gt;<br />
          :<br />
          :<br />
   &lt;/table&gt;<br />

 

<br />
$(document).ready(function() {<br />
    $('#example').DataTable();<br />
} );<br />

 

デフォルトの基本機能

上部から表示件数の切り替え、検索(全カラム対象)、ソート、件数表示、ページングは上記記述だけで自動的に実装される。

基本機能以外にも拡張機能としていろいろ用意されており、Downloadページで必要な機能を選択してダウンロードまたはCDNのURLを作成することができる。選び方等は追々書く予定。

 

基本機能の変更

“datatabels_custom.js” を編集して見た目を変更する。


 

<br />
$(document).ready(function() {<br />
    $('#example').DataTable({<br />
        /**<br />
         * 配置換え (https://datatables.net/examples/basic_init/dom.html)<br />
         * 左上から順に指定していく<br />
         *   &lt;&quot;top&quot;&gt; : テーブルヘッダの上部<br />
         *   f : Filtering input (検索)<br />
         *   r : pRocessing (読み込み時に「処理中」というメッセージを出力)<br />
         *   t : Table (テーブル本体)<br />
         *   &lt;&quot;bottom&quot;&gt; : テーブルボトムの下部<br />
         *   l : Length changing (表示件数切替)<br />
         *   i : Information (件数)<br />
         *   p : Pagenation (ページング)<br />
         *   &lt;&quot;clear&quot;&gt; : &lt;div class=&quot;clear&quot;&gt;&lt;/div&gt;<br />
         */<br />
        dom: '&lt;&quot;top&quot;f&gt;rt&lt;&quot;bottom&quot;lip&gt;&lt;&quot;clear&quot;&gt;',</p>
<p>        /**<br />
         * 日本語化<br />
         */<br />
        language: {<br />
            url: &quot;https://cdn.datatables.net/plug-ins/1.10.15/i18n/Japanese.json&quot;<br />
        },</p>
<p>        /**<br />
         * 件数切替の刻みを変更 (デフォルトは [ 10, 25, 50, 100 ])<br />
         * ・決められた件数の刻みだけの場合<br />
         *   lengthMenu: [10, 50, 100, 1000]<br />
         * ・決められた件数 + 全て(All)の表示をしたい場合<br />
         *   0以下の件数を指定することで、ページネーションを無効化<br />
         */<br />
        lengthMenu: [[10, 50, 100, 500, -1], [10, 50, 100, 500, &quot;全&quot;]]<br />
    });<br />
} );<br />

 

次回以降では、さらに踏み込んでカスタマイズしていく予定。