MiniUI 的 grid 元件預設每格各自獨立,但報表類場景經常需要把相鄰的格子合併成一塊——例如多列的合計欄、跨列的類別標籤。這時候就要用到 margeCells 方法。

合併的時機建議放在 load 事件裡,確保資料已經渲染完成、行數與欄位都對得上:
grid.on("load", onLoad);
function onLoad(e) {
var grid = e.sender;
var marges = [
{ rowIndex: 1, columnIndex: 0, rowSpan: 1, colSpan: 2 },
{ rowIndex: 3, columnIndex: 0, rowSpan: 4, colSpan: 3 }
];
grid.margeCells(marges);
}
margeCells 接受一個合併規則陣列,每條規則包含四個欄位:
以第一段規則為例,它表示「從第 1 列第 0 欄開始,橫向合併 2 欄、縱向不跨列」,也就是把同一列上相鄰的兩個格子併成一格。第二段規則則是從第 3 列第 0 欄出發,向下跨 4 列、向右跨 3 欄,形成一個區塊狀的大格。
索引一律從 0 起算,且行索引通常指的是資料列的順序,表頭是否計入要依 MiniUI 版本而定,實作時建議先印一次 grid.getRows().length 確認。另外,合併規則若涉及資料變動後的重新繪製,記得在 setData 或篩選完成後再次呼叫 margeCells,否則合併狀態可能不會自動保留。