EasyUI Datagrid 是經典的數據表格組件。本文詳細說明 updateRow 方法的用法、參數結構、formatter 列渲染、常見坑點與最佳實踐。
$('#grid').datagrid('updateRow', {
index: rowIndex, // 行索引(0-based)
row: { // 新數據對象,僅覆蓋指定字段
field1: 'newValue1',
field2: 'newValue2'
}
});
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| index | Number | 是 | 要更新的行索引,-1 表示新增行(配合 appendRow) |
| row | Object | 是 | 新數據,僅合併指定字段,未指定字段保持原值 |
var grid = $("#QualityAdd");
var gridIndex = 2; // 目標行索引
var newHtml = '<a href="#">' + r[0].html + '</a>'; // r 為後端返回數據
grid.datagrid('updateRow', {
index: gridIndex,
row: {
Url: newHtml // 僅更新 Url 字段
}
});
columns: [[
{
title: '訂單編號',
field: 'no',
width: 100,
formatter: function(value, row, index) {
// value: 當前字段值 | row: 整行數據 | index: 行索引
// 此處 row.Order.no 來自嵌套數據結構
return row.Order.no;
}
},
{
title: '操作',
field: 'Url',
width: 150,
formatter: function(value, row, index) {
// value 即 row.Url,可能是 標籤字符串
return value; // 直接輸出 HTML
}
}
]]
// Datagrid 加載的數據格式
{
"total": 100,
"rows": [
{
"No": "001",
"Order": { "no": "00101", "amount": 10 },
"Url": "<a href='#'>查看詳情</a>"
}
// ...
]
}
| 操作 | 方法 | 說明 |
|---|---|---|
| 更新行 | updateRow |
部分字段合併更新 |
| 新增行 | appendRow / insertRow |
末尾追加 / 指定索引插入 |
| 刪除行 | deleteRow |
按索引刪除 |
| 獲取行 | getRows / getSelected / getSelections |
獲取所有/選中行數據 |
| 刷新行 | refreshRow |
重新渲染指定行(調用 formatter) |
| 開始/結束編輯 | beginEdit / endEdit / cancelEdit |
行編輯模式控制 |
updateRow 合併字段,不會替換整個 row 對象引用,formatter 看到的是合併後的數據$('#grid').datagrid('refreshRow', index) 強制重繪loadData 重載vue-grid-layout、react-data-grid、antd Table、element-plus TableupdateRow 是 EasyUI Datagrid 高頻 API,掌握「部分字段合併」、「formatter 渲染 HTML」、「索引管理」三大核心點,即可應對絕多數行級更新場景。新專案建議選用現代表格庫,獲得更好類型支援、虛擬化性能、生態工具鏈。