游乐游手机版
首页/前端开发/文章详情

jQuery EasyUI 数据网格启用行内编辑完整教程

时间:2026-08-31 12:03
本文介绍如何在 jQuery EasyUI 数据网格中启用行内编辑功能,涵盖 DataGrid 初始化、列编辑器配置、行状态切换及操作函数实现,帮助开发者快速构建可交互的数据表格界面。

在 jQuery EasyUI 中,数据网格(DataGrid)默认仅支持数据展示,若需直接在表格中修改或新增记录,需启用行内编辑功能。本文通过完整示例演示如何配置列编辑器、绑定编辑事件并实现保存与取消逻辑,帮助开发者快速掌握行内编辑的实现路径与关键判断依据。

初始化数据网格与基础配置

启用行内编辑的第一步是正确初始化 DataGrid 组件。通过设置 singleSelect: true 限制单选模式,并指定 idField: 'itemid' 作为唯一标识字段,确保后续编辑操作能准确定位目标行。数据源通过 url: 'datagrid_data.json' 加载,列定义中需预留 action 列用于渲染操作按钮。

$(function(){
    $('#tt').datagrid({
        title:'Editable DataGrid',
        iconCls:'icon-edit',
        width:660,
        height:250,
        singleSelect:true,
        idField:'itemid',
        url:'datagrid_data.json',
        columns:[[...]],
        onBeforeEdit:function(index,row){
            row.editing = true;
            updateActions(index);
        },
        onAfterEdit:function(index,row){
            row.editing = false;
            updateActions(index);
        },
        onCancelEdit:function(index,row){
            row.editing = false;
            updateActions(index);
        }
    });
});

上述配置中绑定了三个核心事件:onBeforeEditonAfterEditonCancelEdit,用于在编辑生命周期中切换行状态并刷新操作列。

配置列编辑器类型与参数

在列定义中为需要编辑的字段添加 editor 属性,即可激活对应类型的输入控件。EasyUI 支持多种内置编辑器,如 textnumberboxcomboboxcheckbox

{field:'productid',title:'Product',width:100,
    formatter:function(value){
        for(var i=0; i

其中 combobox 编辑器通过 data: products 绑定本地数据源,required: true 强制用户选择有效值;checkbox 编辑器通过 onoff 定义选中与未选中时的实际存储值。

实现编辑、保存与取消操作

操作列通过 formatter 动态生成按钮链接,根据当前行是否处于编辑状态显示不同操作项。点击按钮时调用对应函数,并通过 getRowIndex 获取目标行索引。

function getRowIndex(target){
    var tr = $(target).closest('tr.datagrid-row');
    return parseInt(tr.attr('datagrid-row-index'));
}
function editrow(target){
    $('#tt').datagrid('beginEdit', getRowIndex(target));
}
function deleterow(target){
    $.messager.confirm('Confirm','Are you sure?',function(r){
        if (r){
            $('#tt').datagrid('deleteRow', getRowIndex(target));
        }
    });
}
function saverow(target){
    $('#tt').datagrid('endEdit', getRowIndex(target));
}
function cancelrow(target){
    $('#tt').datagrid('cancelEdit', getRowIndex(target));
}

beginEdit 触发编辑模式,endEdit 提交更改并触发 onAfterEditcancelEdit 放弃修改并触发 onCancelEdit。删除操作前通过 $.messager.confirm 进行二次确认,防止误删。

同步行编辑状态与界面更新

编辑状态切换后,需同步更新操作列按钮显示。通过 updateActions 函数调用 updateRow 方法刷新指定行,确保界面与数据状态一致。

function updateActions(index){
    $('#tt').datagrid('updateRow',{
        index: index,
        row:{}
    });
}

该函数在 onBeforeEditonAfterEditonCancelEdit 中均被调用,保证每次状态变更后操作列能正确渲染 Edit/DeleteSave/Cancel 按钮。

jQuery EasyUI 数据网格行内编辑界面示例
来源:https://www.runoob.com/jeasyui/jeasyui-datagrid-datagrid12.html
上一篇jQuery EasyUI 数据网格扩展 numberspinner 编辑器教程 下一篇jQuery EasyUI 数据网格自定义分页实现教程
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
HTML超链接标签详解:语法、属性与样式
前端开发 · 2026-08-31

HTML超链接标签详解:语法、属性与样式

本文系统讲解HTML中标签的语法结构、核心属性(href与target)及浏览器默认样式。通过代码示例与属性对照表,帮助开发者掌握链接目标设置、窗口打开方式控制及链接状态样式原理,为网页导航与交互开发提供基础依据。

CSS链接样式:4种伪类选择器详解与示例
前端开发 · 2026-08-31

CSS链接样式:4种伪类选择器详解与示例

本文详解CSS中用于控制链接样式的四种伪类选择器::link、:visited、:hover和:active。通过完整示例代码与运行效果演示,帮助开发者掌握链接状态样式的定义方法,并理解伪类书写顺序规则,避免样式覆盖问题。

CSS margin(外边距)属性详解与折叠机制
前端开发 · 2026-08-31

CSS margin(外边距)属性详解与折叠机制

本文系统讲解CSS margin属性的设置方法、取值规则与简写语法,重点剖析相邻兄弟元素与父子元素之间的外边距折叠机制。通过完整示例与图示,帮助开发者准确控制元素间距,避免布局错位,并补充现代CSS实践建议。

CSS计数器精讲:属性语法、嵌套用法与实战示例
前端开发 · 2026-08-31

CSS计数器精讲:属性语法、嵌套用法与实战示例

CSS计数器通过counter-reset、counter-increment和content属性实现纯CSS自动编号。本文详解初始化、自增、显示与嵌套逻辑,提供完整代码示例与注意事项,帮助开发者在不依赖JavaScript的情况下快速生成章节序号、列表编号等结构化内容。

CSS 渐变色(颜色渐变)10分钟入门
前端开发 · 2026-08-31

CSS 渐变色(颜色渐变)10分钟入门

本文系统讲解 CSS3 中的四种渐变类型:线性渐变、径向渐变、圆锥渐变及重复渐变。通过语法解析、参数说明与完整 HTML 示例代码,帮助开发者快速掌握渐变色的创建方法,并了解其在实际网页设计中的应用技巧。