Web Collaboration by PukiWiki-付録3 自作プラグイン一覧-datatable.inc.php

datatable.inc.php†

サマリ|ソートや検索、ページネーションなどが可能なテーブルプラグイン
テーブルにソートや検索、ページネーション、ヘッダー固定のスクロールといった機能をもたせることができます。
ソート条件の指定や1ページの表示件数の変更など細かい調整も可能。

ダウンロード†

• github.com:kanateko/pukiwiki-plugin/raw/master/datatable.inc.php

インストール†

• 上記URLの内容を「datatable.inc.php」の名前で保存してpluginフォルダに入れる

プラグインの設定†

DATATABLE_CDN_CSS

使用するライブラリ (Simple-DataTables) のCDN

DATATABLE_CDN_JS

同上

DATATABLE_TRANSLATE_LABELS

各機能のラベルを日本語化する。デフォルトはtrue

DATATABLE_ENABLE_SORT

ソート機能を有効化する。デフォルトはtrue

DATATABLE_ENABLE_SEARCH

検索機能を有効化する。デフォルトはtrue

DATATABLE_ENABLE_PAGING

ページネーションを有効化する。デフォルトはfalse*1

DATATABLE_PER_PAGE

ページネーション有効時、1ページに表示するデータ件数の初期値。デフォルトは10

DATATABLE_PER_PAGE_SELECT

ページネーション有効時、1ページに表示するデータ件数の選択肢デフォルトは5|10|25|50|100*2*3

使用方法†

 #datatable([オプション]){{
 <テーブル>
 }}

特にオプションで指定がない場合はデフォルトで全カラムをソート可能にします。

オプション†

• true / false 以外のオプションの設定例
  • perPage=25
  • perPageSelect=10|50|100
  • scrollY=200px

基本は「オプション名=値」で指定できますが、以下の条件に当てはまる場合はより簡単に指定できます。

• 各機能の有効化
  • デフォルトがfalseの機能はオプション名だけで有効化できます
    • 例：firstLast、paging

• 各機能の無効化
  • デフォルトがtrueの機能は「no + オプション名」で無効化できます
  • sortableとsearchableのみそれぞれ「nosort」「nosearch」でも無効化可能
    • 例：noheader、nonextPrev

カラム毎のソート設定†

カラムの数だけ "|" で区切ってソートタイプ (もしくは非表示、ソートなし) を指定します。

指定可能なオプション

• string (文字列)
• number (数値)
• date (日付)
• hide (非表示)

上記以外の指定、もしくは空欄の場合、そのカラムはソートなしになります。
また、dateの場合はdate=DD/MM/YYのようにフォーマットを指定できます。
それ以外にもISO_8601、RFC_2822、MYSQLといった規定のフォーマットを指定することも可能です。

使用例と実際の動作はダウンロードの項に記載してあるリンク先で確認してください。

出力結果†

最新の20件