jQuery の tablesorter プラグインの、導入方法、使い方、CSSテーマ、オプションなどについて。jQuery の tablesorter プラグインは、表(テーブル)の列の見出しをクリックすることで、その列の値を基準に、行を並べ替えることができるようにするプラグイン。
導入
jQuery plugin: Tablesorterより、「 jquery.tablesorter.zip 」をダウンロード。
解凍すると、複数のファイルが現れるが、下の実装例(サンプル)のように、並べ替えるだけなら、「jquery.js」と「jquery.tablesorter.js」だけで動作する。
実装例(サンプル)
商品名 ⥮ | id ⥮ | 値段 ⥮ | 評価 ⥮ | デザイン ⥮ |
---|---|---|---|---|
A商品 | 2256 | 8800 | 54 | 73 |
B商品 | 2011 | 5900 | 71 | 52 |
C商品 | 7025 | 15000 | 97 | 100 |
D商品 | 1023 | 8800 | 62 | 63 |
E商品 | 5123 | 8800 | 62 | 73 |
実装例(サンプル)について
実装例(サンプル)のソースコードについては、こちら。
tablesorter プラグインの使い方
基本
「jquery.tablesorter.js」を読み込み、「JavaScript」と「HTML」を下記のように書く。
JavaScript
<!--
jQuery( function() {
jQuery( '#jquery-tablesorter-table' ) . tablesorter();
} );
// -->
</script>
HTML
「thead」と「tbody」タグを含める必要があるようだ。
<thead>
<tr>
<th>見出し1</th>
<th>見出し2</th>
<th>見出し3</th>
</tr>
</thead>
<tbody>
<tr>
<td>項目1</td>
<td>項目1</td>
<td>項目1</td>
</tr>
<tr>
<td>項目2</td>
<td>項目2</td>
<td>項目2</td>
</tr>
</tbody>
</table>
CSSテーマ
「 jquery.tablesorter.zip 」には、「blue」テーマと「green」テーマが含まれている。「themes/blue/」フォルダに、「blue」テーマのCSSファイルと画像ファイルがあり、「themes/green/」フォルダに、「green」テーマのCSSファイルと画像ファイルがある。
テーマを読み込み、「table」タグのクラスに、「tablesorter」を追加すると使える。
HTML
<thead>
<tr>
<th>見出し1</th>
<th>見出し2</th>
<th>見出し3</th>
</tr>
</thead>
<tbody>
<tr>
<td>項目1</td>
<td>項目1</td>
<td>項目1</td>
</tr>
<tr>
<td>項目2</td>
<td>項目2</td>
<td>項目2</td>
</tr>
</tbody>
</table>
オプション
よく使うオプション。
- headers
特定の列に対してオプションを指定することができるオプション。
一部の列の並べ替えを無効にしたいときなどに使う。
- sortList
ページ読み込み時の並び替え基準を指定するオプション。
- sortMultiSortKey
複数の列を基準とした並べ替え(マルチソート)を行うときの操作キーを設定するオプション。
- widgets
奇数行と偶数行の背景色を色分けするときなどに使用。
- sortForce
優先並べ替え基準にする列を指定するオプション。