jQuery EasyUI 教程

jQuery EasyUI 扩展 - 可编辑的数据网格(Editable DataGrid)


jQuery EasyUI 扩展 jQuery EasyUI 扩展

用法

在 html 标签中创建数据网格(datagrid)

<table id="tt" style="width:600px;height:200px" title="Editable DataGrid" singleSelect="true">
  <thead>
    <tr>
      <th field="itemid" width="100" editor="{type:'validatebox',options:{required:true}}">Item ID</th>
      <th field="productid" width="100" editor="text">Product ID</th>
      <th field="listprice" width="100" align="right" editor="{type:'numberbox',options:{precision:1}}">List Price</th>
      <th field="unitcost" width="100" align="right" editor="numberbox">Unit Cost</th>
      <th field="attr1" width="150" editor="text">Attribute</th></tr>
  </thead>
</table>

让数据网格(datagrid)可编辑

$('#tt').edatagrid({
    url: 'datagrid_data.json',
    saveUrl: ...,
    updateUrl: ...,
    destroyUrl: ...
});

现在您可以双击数据网格行开始编辑操作。您也可以设置 saveUrl、updateUrl、destroyUrl 属性来自动同步客户端与服务器端的数据。

属性

该属性扩展自数据网格(datagrid),下面是为可编辑的数据网格(edatagrid)添加的属性。

名称 类型 描述 默认值
destroyMsg object 当销毁一行时要显示的确认对话框消息。
destroyMsg:{
	norecord:{	// when no record is selected
		title:'Warning',
		msg:'No record is selected.'
	},
	confirm:{	// when select a row
		title:'Confirm',
		msg:'Are you sure you want to delete?'
	}
}
autoSave boolean 设置为 true,则当点击数据网格外部时自动保存编辑行。 false
url string 一个 URL,从服务器检索数据。 null
saveUrl string 一个 URL,向服务器保存数据,并返回添加的行。 null
updateUrl string 一个 URL,向服务器更新数据,并返回更新的行。 null
destroyUrl string 一个 URL,向服务器传送 'id' 参数来销毁该行。 null
tree selector 显示对应的树组件的树选择器。 null
treeUrl string 一个 URL,检索树的数据。 null
treeDndUrl string 一个 URL,处理拖放操作。 null
treeTextField string 定义树的文本字段名称。 name
treeParentField string 定义树的父节点字段名称。 parentId

事件

该事件扩展自数据网格(datagrid),下面是为可编辑的数据网格(edatagrid)添加的事件。

名称 参数 描述
onAdd index,row 当添加一个新行时触发。
onEdit index,row 当编辑一行时触发。
onBeforeSave index 一行被保存之前触发,返回 false 则取消保存动作。
onSave index,row 当保存一行时触发。
onDestroy index,row 当销毁一行时触发。
onError index,row 当发生服务器错误时触发。
服务器应返回一个 'isError' 属性设置为 true 的行,表示发生错误。

代码实例:

//server side code
echo json_encode(array(
	'isError' => true,
	'msg' => 'error message.'
));
//client side code
$('#dg').edatagrid({
	onError: function(index,row){
		alert(row.msg);
	}
});

方法

该方法扩展自数据网格(datagrid),下面是为可编辑的数据网格(edatagrid)添加或重写的方法。

名称 参数 描述
options none 返回选项(options)对象。
enableEditing none 启用数据网格(datagrid)编辑。
disableEditing none 禁用数据网格(datagrid)编辑。
editRow index 编辑指定的行。
addRow index 向指定的行索引添加一个新行。
如果 index 参数未指定,则向最后的位置追加一个新行。

代码实例:

// append an empty row
$('#dg').edatagrid('addRow');

// append an empty row as first row
$('#dg').edatagrid('addRow',0);

// insert a row with default values
$('#dg').edatagrid('addRow',{
	index: 2,
	row:{
		name:'name1',
		addr:'addr1'
	}
});
saveRow none 保存编辑行,发布到服务器。
cancelRow none 取消编辑行。
destroyRow index 销毁当前选中的行。
如果 index 参数未指定,则销毁所有选中的行。

代码实例:

// destroy all the selected rows
$('#dg').edatagrid('destroyRow');

// destroy the first row
$('#dg').edatagrid('destroyRow', 0);

// destroy the specified rows
$('#dg').edatagrid('destroyRow', [3,4,5]);

下载 jQuery EasyUI 实例

jquery-easyui-edatagrid.zip


jQuery EasyUI 扩展 jQuery EasyUI 扩展