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）添加的属性。

名称类型描述默认值
destroyMsgobject当销毁一行时要显示的确认对话框消息。
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?'
    }
}
autoSaveboolean设置为 true，则当点击数据网格外部时自动保存编辑行。false
urlstring一个 URL，从服务器检索数据。null
saveUrlstring一个 URL，向服务器保存数据，并返回添加的行。null
updateUrlstring一个 URL，向服务器更新数据，并返回更新的行。null
destroyUrlstring一个 URL，向服务器传送 'id' 参数来销毁该行。null
treeselector显示对应的树组件的树选择器。null
treeUrlstring一个 URL，检索树的数据。null
treeDndUrlstring一个 URL，处理拖放操作。null
treeTextFieldstring定义树的文本字段名称。name
treeParentFieldstring定义树的父节点字段名称。parentId

事件

该事件扩展自数据网格（datagrid），下面是为可编辑的数据网格（edatagrid）添加的事件。

名称参数描述
onAddindex,row当添加一个新行时触发。
onEditindex,row当编辑一行时触发。
onBeforeSaveindex一行被保存之前触发，返回 false 则取消保存动作。
onSaveindex,row当保存一行时触发。
onDestroyindex,row当销毁一行时触发。
onErrorindex,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）添加或重写的方法。

名称参数描述
optionsnone返回选项（options）对象。
enableEditingnone启用数据网格（datagrid）编辑。
disableEditingnone禁用数据网格（datagrid）编辑。
editRowindex编辑指定的行。
addRowindex向指定的行索引添加一个新行。
如果 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'
    }
});
saveRownone保存编辑行，发布到服务器。
cancelRownone取消编辑行。
destroyRowindex销毁当前选中的行。
如果 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 扩展