DIV CSS 佈局教程網

MiniUI 表格實戰:用 margeCells 合併單元格
編輯:JQuery特效代碼     

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 接受一個合併規則陣列,每條規則包含四個欄位:

  • rowIndex:起始行的索引。
  • columnIndex:起始欄的索引。
  • rowSpan:縱向跨越的行數。
  • colSpan:橫向跨越的欄數。

以第一段規則為例,它表示「從第 1 列第 0 欄開始,橫向合併 2 欄、縱向不跨列」,也就是把同一列上相鄰的兩個格子併成一格。第二段規則則是從第 3 列第 0 欄出發,向下跨 4 列、向右跨 3 欄,形成一個區塊狀的大格。

幾個實務提醒

索引一律從 0 起算,且行索引通常指的是資料列的順序,表頭是否計入要依 MiniUI 版本而定,實作時建議先印一次 grid.getRows().length 確認。另外,合併規則若涉及資料變動後的重新繪製,記得在 setData 或篩選完成後再次呼叫 margeCells,否則合併狀態可能不會自動保留。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved