萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery EasyUI Datagrid 更新行數據完整指南

前言

EasyUI Datagrid 是經典的數據表格組件。本文詳細說明 updateRow 方法的用法、參數結構、formatter 列渲染、常見坑點與最佳實踐。

updateRow 基礎語法

$('#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 配置與 formatter 渲染

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 行編輯模式控制

避坑指南

  1. formatter 返回 HTML 字符串:EasyUI 不會自動轉義,直接輸出 HTML。注意 XSS 風險,動態內容需轉義
  2. index 索引變化:刪除/插入行後,後續行索引改變,更新前請重新獲取最新索引
  3. row 對象引用:updateRow 合併字段,不會替換整個 row 對象引用,formatter 看到的是合併後的數據
  4. 樣式不生效:更新後若樣式異常,嘗試 $('#grid').datagrid('refreshRow', index) 強制重繪
  5. 大數據量性能:頻繁單行更新會觸發多次重繪,考慮批量更新後 loadData 重載

現代化替代方案

  • DataTables:功能豐富、社區活躍、支援 ES 模組
  • AG Grid:企業級、虛擬滾動、Excel 導出、圖表聯動
  • Vue/React 表格組件:如 vue-grid-layout、react-data-grid、antd Table、element-plus Table

結語

updateRow 是 EasyUI Datagrid 高頻 API,掌握「部分字段合併」、「formatter 渲染 HTML」、「索引管理」三大核心點,即可應對絕多數行級更新場景。新專案建議選用現代表格庫,獲得更好類型支援、虛擬化性能、生態工具鏈。

copyright © 萬盛學電腦網 all rights reserved