DIV CSS 佈局教程網

jQuery EasyUI DataGrid 中文 API 入門:表格元件核心設定
編輯:JQuery特效代碼     

DataGrid 是 jQuery EasyUI 中非常常用的表格元件,主要用於展示大量結構化資料。它擴展自 panel,並可搭配 resizable、linkbutton、pagination 等元件使用。

基本用法

使用時,通常先在頁面中建立一個 table 元素,再透過 datagrid 方法初始化,並設定資料來源與欄位定義。若資料來自遠端,可透過 url 指定 JSON 位址。

常用特性

  • columns:定義表格欄位。
  • frozenColumns:將指定欄位凍結在左側。
  • fitColumns:自動調整欄寬以適應表格寬度。
  • striped:讓奇數列與偶數列使用不同背景色。
  • method:指定請求遠端資料的方式。
  • nowrap:控制資料是否強制換行。
  • idField:指定識別資料列的字段。
  • loadMsg:設定載入資料時的提示文字。
  • pagination:在底部顯示分頁列。
  • rownumbers:顯示行號欄。
  • singleSelect:限制只能選擇單一資料列。
  • sortName 與 sortOrder:設定排序欄位與排序方向。
  • remoteSort:決定是否由伺服器進行排序。

欄位設定

每個欄位可設定 title、field、width、align、sortable、resizable、hidden、checkbox、formatter、styler、sorter 與 editor 等屬性。透過 formatter 可以自訂儲存格顯示內容,透過 editor 則可支援行內編輯。

事件

DataGrid 提供多種事件,例如 onLoadSuccess、onLoadError、onBeforeLoad、onClickRow、onDblClickRow、onClickCell、onDblClickCell、onSortColumn、onResizeColumn、onSelect、onUnselect、onSelectAll、onUnselectAll、onBeforeEdit、onAfterEdit、onCancelEdit、onHeaderContextMenu 與 onRowContextMenu。

方法

常用方法包含 load、reload、loadData、getData、getRows、getSelected、getSelections、selectRow、unselectRow、beginEdit、endEdit、cancelEdit、updateRow、appendRow、insertRow、deleteRow、getChanges、acceptChanges、rejectChanges、mergeCells、showColumn 與 hideColumn。

結語

DataGrid 的設計重點在於資料展示、排序、分頁、選擇與編輯。掌握欄位設定與常用事件,就能快速建立功能完整的表格介面。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved