jQuery EasyUI 基礎プラグイン -Pagination ページネーション
jQuery EasyUI プラグイン
$.fn.pagination.defaults を使用してデフォルトの defaults を上書きします。
ページネーション(pagination)は、ユーザーがページをめくってデータをナビゲートできるようにします。ページナビゲーションとページ長さの選択の設定可能なオプションをサポートしています。ユーザーはページネーションの右側にカスタムボタンを追加して機能を拡張できます。
依存
- linkbutton
使用法
マークアップでページネーション(pagination)を作成します。
<div id="pp" class="easyui-pagination" style="background:#EFEFEF;border:1px solid #ccc;"
data-options="total:2000,pageSize:10">
</div>
JavaScript を使用してページネーション(pagination)を作成します。
<div id="pp" style="background:#EFEFEF;border:1px solid #ccc;"></div>
$('#pp').pagination({
total:2000,
pageSize:10
});
パネル(panel)とページネーション(pagination)プラグインを使用して Ajax ページネーション(pagination)を作成しましょう。ユーザーが新しいページを選択すると、パネル(panel)は指定されたページの対応するコンテンツを表示します。
<div id="content" class="easyui-panel" style="height:200px"
data-options="href:'show_content.php?page=1'">
</div>
<div class="easyui-pagination" style="border:1px solid #ccc;"
data-options="
total: 2000,
pageSize: 10,
onSelectPage: function(pageNumber, pageSize){
$('#content').panel('refresh', 'show_content.php?page='+pageNumber);
}">
</div>
上部のパネル(panel)はデフォルトで最初のページのコンテンツを表示します。ユーザーがページをナビゲートすると、'onSelectPage' イベントがトリガーされ、そのイベントはコンテンツパネル(panel)の 'refresh' メソッドを呼び出して、新しい URL パラメータを持つ新しいページのコンテンツを読み込みます。
プロパティ
| 名前 | 型 | 説明 | デフォルト値 |
|---|---|---|---|
| total | number | レコードの総数。ページネーション(pagination)を作成するときに設定する必要があります。 | 1 |
| pageSize | number | ページサイズ。(注:各ページに表示される最大レコード数) | 10 |
| pageNumber | number | ページネーション(pagination)を作成するときに表示されるページ番号。 | 1 |
| pageList | array | ユーザーはページサイズを変更できます。pageList プロパティは、変更できるサイズを定義します。 コード例:
$('#pp').pagination({
pageList: [10,20,50,100]
});
|
[10,20,30,50] |
| loading | boolean | データの読み込み中かどうかを定義します。 | false |
| buttons | array,selector | カスタムボタンを定義します。可能な値: 1. 配列。各ボタンには2つのプロパティが含まれます: iconCls:CSS クラス。背景画像を表示します。 handler:ボタンがクリックされたときの処理関数 2. セレクタ。ボタンを指定します。 ボタンはマークアップで宣言できます:
<div class="easyui-pagination" style="border:1px solid #ccc" data-options="
total: 114,
buttons: [{
iconCls:'icon-add',
handler:function(){alert('add')}
},'-',{
iconCls:'icon-save',
handler:function(){alert('save')}
}]">
</div>
ボタンは JavaScript を使用して作成することもできます:
$('#pp').pagination({
total: 114,
buttons: [{
iconCls:'icon-add',
handler:function(){alert('add')}
},'-',{
iconCls:'icon-save',
handler:function(){alert('save')}
}]
});
|
null |
| layout | array | ページネーションのレイアウト定義。このプロパティはバージョン 1.3.5 から使用可能です。 レイアウト項目には、次の値の1つ以上が含まれます: 1. list:ページサイズリスト。 2. sep:ページボタンの区切り。 3. first:最初のボタン。 4. prev:前のボタン。 5. next:次のボタン。 6. last:最後のボタン。 7. efresh:更新ボタン。 8. manual:ページ番号を入力するための手動ページ番号入力ボックスを許可します。 9. links:ページ番号リンク。 コード例:
$('#pp').pagination({
layout:['first','links','last']
});
|
|
| links | number | リンク数。'links' 項目が 'layout' に含まれている場合にのみ有効です。このプロパティはバージョン 1.3.5 から使用可能です。 | 10 |
| showPageList | boolean | ページリストを表示するかどうかを定義します。 | true |
| showRefresh | boolean | 更新ボタンを表示するかどうかを定義します。 | true |
| beforePageText | string | input コンポーネントの前に label を表示します。 | Page |
| afterPageText | string | input コンポーネントの後に label を表示します。 | of {pages} |
| displayMsg | string | Display a page information. | {from} to {to} of {total} のページ情報を表示します。 |
イベント
| 名前 | パラメータ | 説明 |
|---|---|---|
| onSelectPage | pageNumber, pageSize | ユーザーが新しいページを選択したときにトリガーされます。コールバック関数には2つのパラメータが含まれます: pageNumber:新しいページ番号 pageSize:新しいページサイズ コード例:
$('#pp').pagination({
onSelectPage:function(pageNumber, pageSize){
$(this).pagination('loading');
alert('pageNumber:'+pageNumber+',pageSize:'+pageSize);
$(this).pagination('loaded');
}
});
|
| onBeforeRefresh | pageNumber, pageSize | 更新ボタンがクリックされる前にトリガーされます。false を返すと更新アクションがキャンセルされます。 |
| onRefresh | pageNumber, pageSize | 更新後にトリガーされます。 |
| onChangePageSize | pageSize | ユーザーがページサイズを変更したときにトリガーされます。 |
メソッド
| 名前 | パラメータ | 説明 |
|---|---|---|
| options | none | オプション(options)オブジェクトを返します。 |
| loading | none | ページネーション(pagination)を読み込み中(loading)状態にします。 |
| loaded | none | ページネーション(pagination)を読み込み完了(loaded)状態にします。 |
| refresh | options | 更新してページネーション情報を表示します。このメソッドはバージョン 1.3 から使用可能です。 コード例:
$('#pp').pagination('refresh'); // 刷新分页栏信息
$('#pp').pagination('refresh',{ // 改变选项,并刷新分页栏信息
total: 114,
pageNumber: 6
});
|
| select | page | 新しいページを選択します。ページインデックスは 1 から始まります。このメソッドはバージョン 1.3 から使用可能です。 コード例:
$('#pp').pagination('select'); // 刷新当前页面
$('#pp').pagination('select', 2); // 选择第二页
|
jQuery EasyUI プラグイン その他の拡張機能