jQuery EasyUI 數(shù)據(jù)網(wǎng)格與樹插件 – Datagrid 數(shù)據(jù)網(wǎng)格

2018-09-20 05:09 更新

jQuery EasyUI 數(shù)據(jù)網(wǎng)格與樹插件 - Datagrid 數(shù)據(jù)網(wǎng)格


jQuery EasyUI 插件 jQuery EasyUI 插件

擴(kuò)展自 $.fn.panel.defaults。通過 $.fn.datagrid.defaults 重寫默認(rèn)的 defaults。

數(shù)據(jù)網(wǎng)格(datagrid)以表格格式顯示數(shù)據(jù),并為選擇、排序、分組和編輯數(shù)據(jù)提供了豐富的支持。數(shù)據(jù)網(wǎng)格(datagrid)的設(shè)計(jì)目的是為了減少開發(fā)時(shí)間,且不要求開發(fā)人員具備指定的知識(shí)。它是輕量級(jí)的,但是功能豐富。它的特性包括單元格合并,多列頁(yè)眉,凍結(jié)列和頁(yè)腳,等等。

依賴

  • panel
  • resizable
  • linkbutton
  • pagination

用法

從已有的表格元素創(chuàng)建數(shù)據(jù)網(wǎng)格(datagrid),在 html 中定義列、行及數(shù)據(jù)。

<table class="easyui-datagrid">
    <thead>
		<tr>
			<th data-options="field:'code'">Code</th>
			<th data-options="field:'name'">Name</th>
			<th data-options="field:'price'">Price</th>
		</tr>
    </thead>
    <tbody>
		<tr>
			<td>001</td><td>name1</td><td>2323</td>
		</tr>
		<tr>
			<td>002</td><td>name2</td><td>4612</td>
		</tr>
	</tbody>
</table>

通過 <table> 標(biāo)記創(chuàng)建數(shù)據(jù)網(wǎng)格(datagrid)。嵌套的 <th> 標(biāo)簽定義表格中的列。

<table class="easyui-datagrid" style="width:400px;height:250px"     data-options="url:'datagrid_data.json',fitColumns:true,singleSelect:true">
    <thead>
		<tr>
			<th data-options="field:'code',width:100">Code</th>
			<th data-options="field:'name',width:100">Name</th>
			<th data-options="field:'price',width:100,align:'right'">Price</th>
		</tr>
    </thead>
</table>

也可以使用 javascript 創(chuàng)建數(shù)據(jù)網(wǎng)格(datagrid)。

<table id="dg"></table>
$('#dg').datagrid({
    url:'datagrid_data.json',
    columns:[[
		{field:'code',title:'Code',width:100},
		{field:'name',title:'Name',width:100},
		{field:'price',title:'Price',width:100,align:'right'}
    ]]
});

通過一些參數(shù)查詢數(shù)據(jù)。

$('#dg').datagrid('load', {
    name: 'easyui',
    address: 'ho'
});

在向服務(wù)器改變數(shù)據(jù)之后,更新前臺(tái)數(shù)據(jù)。

$('#dg').datagrid('reload');    // reload the current page data

數(shù)據(jù)網(wǎng)格(DataGrid)屬性

該屬性擴(kuò)展自面板(panel),下面是為數(shù)據(jù)網(wǎng)格(datagrid)添加的屬性。

名稱 類型 描述 默認(rèn)值
columns array 數(shù)據(jù)網(wǎng)格(datagrid)的列(column)的配置對(duì)象,更多細(xì)節(jié)請(qǐng)參見列(column)屬性。 undefined
frozenColumns array 和列(column)屬性一樣,但是這些列將被凍結(jié)在左邊。 undefined
fitColumns boolean 設(shè)置為 true,則會(huì)自動(dòng)擴(kuò)大或縮小列的尺寸以適應(yīng)網(wǎng)格的寬度并且防止水平滾動(dòng)。 false
resizeHandle string 調(diào)整列的位置,可用的值有:'left'、'right'、'both'。當(dāng)設(shè)置為 'right' 時(shí),用戶可通過拖拽列頭部的右邊緣來調(diào)整列。
該屬性自版本 1.3.2 起可用。
right
autoRowHeight boolean 定義是否設(shè)置基于該行內(nèi)容的行高度。設(shè)置為 false,則可以提高加載性能。 true
toolbar array,selector 數(shù)據(jù)網(wǎng)格(datagrid)面板的頭部工具欄??赡艿闹担?br> 1、數(shù)組,每個(gè)工具選項(xiàng)與鏈接按鈕(linkbutton)一樣。
2、選擇器,只是工具欄。

在 <div> 標(biāo)簽內(nèi)定義工具欄:
$('#dg').datagrid({
	toolbar: '#tb'
});
<div id="tb">
<a href="#" class="easyui-linkbutton" data-options="iconCls:'icon-edit',plain:true"></a>
<a href="#" class="easyui-linkbutton" data-options="iconCls:'icon-help',plain:true"></a>
</div>
通過數(shù)組定義工具欄:
$('#dg').datagrid({
	toolbar: [{
		iconCls: 'icon-edit',
		handler: function(){alert('edit')}
	},'-',{
		iconCls: 'icon-help',
		handler: function(){alert('help')}
	}]
});
null
striped boolean 設(shè)置為 true,則把行條紋化。(即奇偶行使用不同背景色) false
method string 請(qǐng)求遠(yuǎn)程數(shù)據(jù)的方法(method)類型。 post
nowrap boolean 設(shè)置為 true,則把數(shù)據(jù)顯示在一行里。設(shè)置為 true 可提高加載性能。 true
idField string 指示哪個(gè)字段是標(biāo)識(shí)字段。 null
url string 從遠(yuǎn)程站點(diǎn)請(qǐng)求數(shù)據(jù)的 URL。 null
data array,object 要加載的數(shù)據(jù)。該屬性自版本 1.3.2 起可用。
代碼實(shí)例:
$('#dg').datagrid({
	data: [
		{f1:'value11', f2:'value12'},
		{f1:'value21', f2:'value22'}
	]
});
null
loadMsg string 當(dāng)從遠(yuǎn)程站點(diǎn)加載數(shù)據(jù)時(shí),顯示的提示消息。 Processing, please wait …
pagination boolean 設(shè)置為 true,則在數(shù)據(jù)網(wǎng)格(datagrid)底部顯示分頁(yè)工具欄。 false
rownumbers boolean 設(shè)置為 true,則顯示帶有行號(hào)的列。 false
singleSelect boolean 設(shè)置為 true,則只允許選中一行。 false
checkOnSelect boolean 如果設(shè)置為 true,當(dāng)用戶點(diǎn)擊某一行時(shí),則會(huì)選中/取消選中復(fù)選框。如果設(shè)置為 false 時(shí),只有當(dāng)用戶點(diǎn)擊了復(fù)選框時(shí),才會(huì)選中/取消選中復(fù)選框。
該屬性自版本 1.3 起可用。
true
selectOnCheck boolean 如果設(shè)置為 true,點(diǎn)擊復(fù)選框?qū)?huì)選中該行。如果設(shè)置為 false,選中該行將不會(huì)選中復(fù)選框。
該屬性自版本 1.3 起可用。
true
pagePosition string 定義分頁(yè)欄的位置??捎玫闹涤校?top'、'bottom'、'both'。
該屬性自版本 1.3 起可用。
bottom
pageNumber number 當(dāng)設(shè)置了 pagination 屬性時(shí),初始化頁(yè)碼。 1
pageSize number 當(dāng)設(shè)置了 pagination 屬性時(shí),初始化頁(yè)面尺寸。 10
pageList array 當(dāng)設(shè)置了 pagination 屬性時(shí),初始化頁(yè)面尺寸的選擇列表。 [10,20,30,40,50]
queryParams object 當(dāng)請(qǐng)求遠(yuǎn)程數(shù)據(jù)時(shí),發(fā)送的額外參數(shù)。
代碼實(shí)例:
$('#dg').datagrid({
	queryParams: {
		name: 'easyui',
		subject: 'datagrid'
	}
});
{}
sortName string 定義可以排序的列。 null
sortOrder string 定義列的排序順序,只能用 'asc' 或 'desc'。 asc
multiSort boolean 定義是否啟用多列排序。該屬性自版本 1.3.4 起可用。 false
remoteSort boolean 定義是否從服務(wù)器排序數(shù)據(jù)。 true
showHeader boolean 定義是否顯示行的頭部。 true
showFooter boolean 定義是否顯示行的底部。 false
scrollbarSize number 滾動(dòng)條寬度(當(dāng)滾動(dòng)條是垂直的時(shí)候)或者滾動(dòng)條的高度(當(dāng)滾動(dòng)條是水平的時(shí)候)。 18
rowStyler function 返回例如 'background:red' 的樣式。該函數(shù)需要兩個(gè)參數(shù):
rowIndex:行的索引,從 0 開始。
rowData:該行相應(yīng)的記錄。

代碼實(shí)例:
$('#dg').datagrid({
	rowStyler: function(index,row){
		if (row.listprice>80){
			return 'background-color:#6293BB;color:#fff;'; // return inline style
			// the function can return predefined css class and inline style
			// return {class:'r1', style:{'color:#fff'}};	
		}
	}
});
loader function 定義如何從遠(yuǎn)程服務(wù)器加載數(shù)據(jù)。返回 false 則取消該動(dòng)作。該函數(shù)有下列參數(shù):
param:要傳遞到遠(yuǎn)程服務(wù)器的參數(shù)對(duì)象。
success(data):當(dāng)檢索數(shù)據(jù)成功時(shí)調(diào)用的回調(diào)函數(shù)。
error():當(dāng)檢索數(shù)據(jù)失敗時(shí)調(diào)用的回調(diào)函數(shù)。
json loader
loadFilter function 返回要顯示的過濾數(shù)據(jù)。該函數(shù)有一個(gè)參數(shù) 'data' ,表示原始數(shù)據(jù)。您可以把原始數(shù)據(jù)變成標(biāo)準(zhǔn)數(shù)據(jù)格式。該函數(shù)必須返回標(biāo)準(zhǔn)數(shù)據(jù)對(duì)象,含有 'total' 和 'rows' 屬性。
代碼實(shí)例:
// removing 'd' object from asp.net web service json output
$('#dg').datagrid({
	loadFilter: function(data){
		if (data.d){
			return data.d;
		} else {
			return data;
		}
	}
});
editors object 定義編輯行時(shí)的編輯器。 predefined editors
view object 定義數(shù)據(jù)網(wǎng)格(datagrid)的視圖。 default view

列(Column)屬性

數(shù)據(jù)網(wǎng)格(DataGrid) 的列(Column)是一個(gè)數(shù)組對(duì)象,它的每個(gè)元素也是一個(gè)數(shù)組。元素?cái)?shù)組的元素是一個(gè)配置對(duì)象,它定義了每個(gè)列的字段。

代碼實(shí)例:

columns:[[
    {field:'itemid',title:'Item ID',rowspan:2,width:80,sortable:true},
    {field:'productid',title:'Product ID',rowspan:2,width:80,sortable:true},
    {title:'Item Details',colspan:4}
],[
    {field:'listprice',title:'List Price',width:80,align:'right',sortable:true},
    {field:'unitcost',title:'Unit Cost',width:80,align:'right',sortable:true},
    {field:'attr1',title:'Attribute',width:100},
    {field:'status',title:'Status',width:60}
]]
名稱 類型 描述 默認(rèn)值
title string 列的標(biāo)題文本。 undefined
field string 列的字段名。 undefined
width number 列的寬度。如果未定義,則寬度會(huì)自動(dòng)擴(kuò)展以適應(yīng)它的內(nèi)容。沒有定義寬度將會(huì)降低性能。 undefined
rowspan number 指示一個(gè)單元格占據(jù)多少行。 undefined
colspan number 指示一個(gè)單元格占據(jù)多少列。 undefined
align string 指示如何對(duì)齊該列的數(shù)據(jù),可以用 'left'、'right'、'center'。 undefined
halign string 指示如何對(duì)齊該列的頭部,可能的值:'left'、'right'、'center'。如果沒有分配值,則頭部對(duì)齊方式將與通過 'align' 屬性定義的數(shù)據(jù)對(duì)齊方式一致。該屬性自版本 1.3.2 起可用。 undefined
sortable boolean 設(shè)置為 true,則允許該列被排序。 undefined
order string 默認(rèn)的排序順序,只能用 'asc' 或 'desc'。該屬性自版本 1.3.2 起可用。 undefined
resizable boolean 設(shè)置為 true,則允許該列可調(diào)整尺寸。 undefined
fixed boolean 設(shè)置為 true,則當(dāng) 'fitColumns' 設(shè)置為 true 時(shí)放置調(diào)整寬度。 undefined
hidden boolean 設(shè)置為 true,則隱藏該列。 undefined
checkbox boolean 設(shè)置為 true,則顯示復(fù)選框。復(fù)選框有固定寬度。 undefined
formatter function 單元格的格式化函數(shù),需要三個(gè)參數(shù):
value:字段的值。
rowData:行的記錄數(shù)據(jù)。
rowIndex:行的索引。

代碼實(shí)例:
$('#dg').datagrid({
	columns:[[
		{field:'userId',title:'User', width:80,
			formatter: function(value,row,index){
				if (row.user){
					return row.user.name;
				} else {
					return value;
				}
			}
		}
	]]
});
undefined
styler function 單元格的樣式函數(shù),返回樣式字符串來自定義該單元格的樣式,例如 'background:red' 。該函數(shù)需要三個(gè)參數(shù):
value:字段的值。
rowData:行的記錄數(shù)據(jù)。
rowIndex:行的索引。

代碼實(shí)例:
$('#dg').datagrid({
	columns:[[
		{field:'listprice',title:'List Price', width:80, align:'right',
			styler: function(value,row,index){
				if (value < 20){ 					return 'background-color:#ffee00;color:red;'; 					// the function can return predefined css class and inline style 					// return {class:'c1',style:'color:red'} 				} 			} 		} 	]] }); 
undefined
sorter function 用于本地排序的自定義字段的排序函數(shù),需要兩個(gè)參數(shù):
a:第一個(gè)字段值。
b:第二個(gè)字段值。

代碼實(shí)例:
$('#dg').datagrid({
	remoteSort: false,
	columns: [[
		{field:'date',title:'Date',width:80,sortable:true,align:'center',  
			sorter:function(a,b){  
				a = a.split('/');  
				b = b.split('/');  
				if (a[2] == b[2]){  
					if (a[0] == b[0]){  
						return (a[1]>b[1]?1:-1);  
					} else {  
						return (a[0]>b[0]?1:-1);  
					}  
				} else {  
					return (a[2]>b[2]?1:-1);  
				}  
			}  
		}
	]]
});
undefined
editor string,object 指示編輯類型。當(dāng)是字符串(string)時(shí)則指編輯類型,當(dāng)是對(duì)象(object)時(shí)則包含兩個(gè)屬性:
type:字符串,編輯類型,可能的類型:text、textarea、checkbox、numberbox、validatebox、datebox、combobox、combotree。
options:對(duì)象,編輯類型對(duì)應(yīng)的編輯器選項(xiàng)。
undefined

編輯器(Editor)

通過 $.fn.datagrid.defaults.editors 重寫默認(rèn)的 defaults。

每個(gè)編輯器有下列行為:

名稱 參數(shù) 描述
init container, options 初始化編輯器并且返回目標(biāo)對(duì)象。
destroy target 如果必要就銷毀編輯器。
getValue target 從編輯器的文本獲取值。
setValue target , value 給編輯器設(shè)置值。
resize target , width 如果必要就調(diào)整編輯器的尺寸。

例如,文本編輯器(text editor)定義如下:

$.extend($.fn.datagrid.defaults.editors, {
    text: {
		init: function(container, options){
			var input = $('<input type="text" class="datagrid-editable-input">').appendTo(container);
			return input;
		},
		destroy: function(target){
			$(target).remove();
		},
		getValue: function(target){
			return $(target).val();
		},
		setValue: function(target, value){
			$(target).val(value);
		},
		resize: function(target, width){
			$(target)._outerWidth(width);
		}
    }
});

數(shù)據(jù)網(wǎng)格視圖(DataGrid View)

通過 $.fn.datagrid.defaults.view 重寫默認(rèn)的 defaults。

視圖(view)是一個(gè)對(duì)象,它告訴數(shù)據(jù)網(wǎng)格(datagrid)如何呈現(xiàn)行。該對(duì)象必須定義下列函數(shù):

名稱 參數(shù) 描述
render target, container, frozen 當(dāng)數(shù)據(jù)加載時(shí)調(diào)用。
target:DOM 對(duì)象,數(shù)據(jù)網(wǎng)格(datagrid)對(duì)象。
container:行的容器。
frozen:指示是否呈現(xiàn)凍結(jié)容器。
renderFooter target, container, frozen 這是呈現(xiàn)行腳的選項(xiàng)函數(shù)。
renderRow target, fields, frozen, rowIndex, rowData 這是將會(huì)被 render 函數(shù)調(diào)用的選項(xiàng)函數(shù)。
refreshRow target, rowIndex 定義如何刷新指定的行。
onBeforeRender target, rows 視圖被呈現(xiàn)前觸發(fā)。
onAfterRender target 視圖被呈現(xiàn)后觸發(fā)。

事件

該事件擴(kuò)展自面板(panel),下面是為數(shù)據(jù)網(wǎng)格(datagrid)添加的事件。

名稱 參數(shù) 描述
onLoadSuccess data 當(dāng)數(shù)據(jù)加載成功時(shí)觸發(fā)。
onLoadError none 加載遠(yuǎn)程數(shù)據(jù)發(fā)生某些錯(cuò)誤時(shí)觸發(fā)。
onBeforeLoad param 發(fā)送加載數(shù)據(jù)的請(qǐng)求前觸發(fā),如果返回 false 加載動(dòng)作就會(huì)取消。
onClickRow rowIndex, rowData 當(dāng)用戶點(diǎn)擊一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:被點(diǎn)擊行的索引,從 0 開始
rowData:被點(diǎn)擊行對(duì)應(yīng)的記錄
onDblClickRow rowIndex, rowData 當(dāng)用戶雙擊一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:被雙擊行的索引,從 0 開始
rowData:被雙擊行對(duì)應(yīng)的記錄
onClickCell rowIndex, field, value 當(dāng)用戶單擊一個(gè)單元格時(shí)觸發(fā)。
onDblClickCell rowIndex, field, value 當(dāng)用戶雙擊一個(gè)單元格時(shí)觸發(fā)。
代碼實(shí)例:
// when double click a cell, begin editing and make the editor get focus
$('#dg').datagrid({
	onDblClickCell: function(index,field,value){
		$(this).datagrid('beginEdit', index);
		var ed = $(this).datagrid('getEditor', {index:index,field:field});
		$(ed.target).focus();
	}
});
onSortColumn sort, order 當(dāng)用戶對(duì)一列進(jìn)行排序時(shí)觸發(fā),參數(shù)包括:
sort:排序的列的字段名
order:排序的列的順序
onResizeColumn field, width 當(dāng)用戶調(diào)整列的尺寸時(shí)觸發(fā)。
onSelect rowIndex, rowData 當(dāng)用戶選中一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:選中行的索引,從 0 開始
rowData:選中行對(duì)應(yīng)的記錄
onUnselect rowIndex, rowData 當(dāng)用戶取消選中一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:取消選中行的索引,從 0 開始
rowData:取消選中行對(duì)應(yīng)的記錄
onSelectAll rows 當(dāng)用戶選中全部行時(shí)觸發(fā)。
onUnselectAll rows 當(dāng)用戶取消選中全部行時(shí)觸發(fā)。
onCheck rowIndex,rowData 當(dāng)用戶勾選一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:勾選行的索引,從 0 開始
rowData:勾選行對(duì)應(yīng)的記錄
該事件自版本 1.3 起可用。
onUncheck rowIndex,rowData 當(dāng)用戶取消勾選一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:取消勾選行的索引,從 0 開始
rowData:取消勾選行對(duì)應(yīng)的記錄
該事件自版本 1.3 起可用。
onCheckAll rows 當(dāng)用戶勾選全部行時(shí)觸發(fā)。該事件自版本 1.3 起可用。
onUncheckAll rows 當(dāng)用戶取消勾選全部行時(shí)觸發(fā)。該事件自版本 1.3 起可用。
onBeforeEdit rowIndex, rowData 當(dāng)用戶開始編輯一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:編輯行的索引,從 0 開始
rowData:編輯行對(duì)應(yīng)的記錄
onAfterEdit rowIndex, rowData, changes 當(dāng)用戶完成編輯一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:編輯行的索引,從 0 開始
rowData:編輯行對(duì)應(yīng)的記錄
changes:更改的字段/值對(duì)
onCancelEdit rowIndex, rowData 當(dāng)用戶取消編輯一行時(shí)觸發(fā),參數(shù)包括:
rowIndex:編輯行的索引,從 0 開始
rowData:編輯行對(duì)應(yīng)的記錄
onHeaderContextMenu e, field 當(dāng)數(shù)據(jù)網(wǎng)格(datagrid)的頭部被右鍵單擊時(shí)觸發(fā)。
onRowContextMenu e, rowIndex, rowData 當(dāng)右鍵點(diǎn)擊行時(shí)觸發(fā)。

方法

名稱 參數(shù) 描述
options none 返回選項(xiàng)(options)對(duì)象。
getPager none 返回分頁(yè)(pager)對(duì)象。
getPanel none 返回面板(panel)對(duì)象。
getColumnFields frozen 返回列的字段,如果 frozen 設(shè)置為 true,則凍結(jié)列的字段被返回。
代碼實(shí)例:
var opts = $('#dg').datagrid('getColumnFields');	// get unfrozen columns
var opts = $('#dg').datagrid('getColumnFields', true); // get frozen columns
getColumnOption field 返回指定列的選項(xiàng)。
resize param 調(diào)整尺寸和布局。
load param 加載并顯示第一頁(yè)的行,如果指定 'param' 參數(shù),它將替換 queryParams 屬性。通常情況下,通過傳遞一些從參數(shù)進(jìn)行查詢,該方法被調(diào)用來從服務(wù)器加載新數(shù)據(jù)。
$('#dg').datagrid('load',{
	code: '01',
	name: 'name01'
});
reload param 重新加載行,就像 load 方法一樣,但是保持在當(dāng)前頁(yè)。
reloadFooter footer 重新加載底部的行。代碼實(shí)例:
// update footer row values and then refresh
var rows = $('#dg').datagrid('getFooterRows');
rows[0]['name'] = 'new name';
rows[0]['salary'] = 60000;
$('#dg').datagrid('reloadFooter');

// update footer rows with new data
$('#dg').datagrid('reloadFooter',[
	{name: 'name1', salary: 60000},
	{name: 'name2', salary: 65000}
]);
loading none 顯示正在加載狀態(tài)。
loaded none 隱藏正在加載狀態(tài)。
fitColumns none 使列自動(dòng)展開/折疊以適應(yīng)數(shù)據(jù)網(wǎng)格(datagrid)的寬度。
fixColumnSize field 固定列的尺寸。如果 'field' 參數(shù)未設(shè)置,所有的列的尺寸將是固定的。
代碼實(shí)例:
$('#dg').datagrid('fixColumnSize', 'name');  // fix the 'name' column size
$('#dg').datagrid('fixColumnSize');  // fix all columns size
fixRowHeight index 固定指定行的高度。如果 'index' 參數(shù)未設(shè)置,所有的行的高度將是固定的。
freezeRow index 凍結(jié)指定的行,以便數(shù)據(jù)網(wǎng)格(datagrid)向下滾動(dòng)時(shí)這些凍結(jié)行總是被顯示在頂部。該方法自版本 1.3.2 起可用。
autoSizeColumn field 調(diào)整列的寬度以適應(yīng)內(nèi)容。該方法自版本 1.3 起可用。
loadData data 加載本地?cái)?shù)據(jù),舊的行會(huì)被移除。
getData none 返回加載的數(shù)據(jù)。
getRows none 返回當(dāng)前頁(yè)的行。
getFooterRows none 返回底部的行。
getRowIndex row 返回指定行的索引,row 參數(shù)可以是一個(gè)行記錄或者一個(gè) id 字段的值。
getChecked none 返回復(fù)選框選中的所有行。該方法自版本 1.3 起可用。
getSelected none 返回第一個(gè)選中的行或者 null。
getSelections none 返回所有選中的行,當(dāng)沒有選中的記錄時(shí),將返回空數(shù)組。
clearSelections none 清除所有的選擇。
clearChecked none 清除所有勾選的行。該方法自版本 1.3.2 起可用。
scrollTo index 滾動(dòng)到指定行。該方法自版本 1.3.3 起可用。
highlightRow index 高亮顯示一行。該方法自版本 1.3.3 起可用。
selectAll none 選中當(dāng)前頁(yè)所有的行。
unselectAll none 取消選中當(dāng)前頁(yè)所有的行。
selectRow index 選中一行,行索引從 0 開始。
selectRecord idValue 通過傳遞 id 的值做參數(shù)選中一行。
unselectRow index 取消選中一行。
checkAll none 勾選當(dāng)前頁(yè)所有的行。該方法自版本 1.3 起可用。
uncheckAll none 取消勾選當(dāng)前頁(yè)所有的行。該方法自版本 1.3 起可用。
checkRow index 勾選一行,行索引從 0 開始。該方法自版本 1.3 起可用。
uncheckRow index 取消勾選一行,行索引從 0 開始。該方法自版本 1.3 起可用。
beginEdit index 開始對(duì)一行進(jìn)行編輯。
endEdit index 結(jié)束對(duì)一行進(jìn)行編輯。
cancelEdit index 取消對(duì)一行進(jìn)行編輯。
getEditors index 獲取指定行的編輯器。每個(gè)編輯器有下列屬性:
actions:編輯器能做的動(dòng)作,與編輯器定義相同。
target:目標(biāo)編輯器的 jQuery 對(duì)象。
field:字段名。
type:編輯器的類型,比如:'text'、'combobox'、'datebox',等等。
getEditor options 獲取指定的編輯器, options 參數(shù)包含兩個(gè)屬性:
index:行的索引。
field:字段名。

代碼實(shí)例:
// get the datebox editor and change its value
var ed = $('#dg').datagrid('getEditor', {index:1,field:'birthday'});
$(ed.target).datebox('setValue', '5/4/2012');
refreshRow index 刷新一行。
validateRow index 驗(yàn)證指定的行,有效時(shí)返回 true。
updateRow param 更新指定的行, param 參數(shù)包括下列屬性:
index:要更新的行的索引。
row:新的行數(shù)據(jù)。

代碼實(shí)例:
$('#dg').datagrid('updateRow',{
	index: 2,
	row: {
		name: 'new name',
		note: 'new note message'
	}
});
appendRow row 追加一個(gè)新行。新的行將被添加在最后的位置:
$('#dg').datagrid('appendRow',{
	name: 'new name',
	age: 30,
	note: 'some messages'
});
insertRow param 插入一個(gè)新行, param 參數(shù)包括下列屬性:
index:插入進(jìn)去的行的索引,如果沒有定義,就追加該新行。
row:行的數(shù)據(jù)。

代碼實(shí)例:
// insert a new row at second row position
$('#dg').datagrid('insertRow',{
	index: 1,	// index start with 0
	row: {
		name: 'new name',
		age: 30,
		note: 'some messages'
	}
});
deleteRow index 刪除一行。
getChanges type 獲取最后一次提交以來更改的行,type 參數(shù)表示更改的行的類型,可能的值是:inserted、deleted、updated,等等。當(dāng) type 參數(shù)沒有分配時(shí),返回所有改變的行。
acceptChanges none 提交自從被加載以來或最后一次調(diào)用 acceptChanges 以來所有更改的數(shù)據(jù)。
rejectChanges none 回滾自從創(chuàng)建以來或最后一次調(diào)用 acceptChanges 以來所有更改的數(shù)據(jù)。
mergeCells options 把一些單元格合并為一個(gè)單元格,options 參數(shù)包括下列特性:
index:列的索引。
field:字段名。
rowspan:合并跨越的行數(shù)。
colspan:合并跨越的列數(shù)。
showColumn field 顯示指定的列。
hideColumn field 隱藏指定的列。

jQuery EasyUI 插件 jQuery EasyUI 插件
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)