dojox.grid.EnhancedGrid.plugins.CellMerge

CellMerge plugin provides functions to merge cells within a row.

Introduction

CellMerge is a plugin for dojox.grid.EnhancedGrid. It provides functions to merge(un-merge) adjacent cells within one row.

This CellMerge plugin is only available for EnhancedGrid, so use the following statement in the head of your HTML file:

The declaration name of this plugin is cellMerge . It is declared in the plugins property of grid.

If your grid is created declaratively:

If your grid is created in JavaScript:

As shown in the above code, you can simply set the cellMerge property to true or false (disabled), or further configure it in an argument object.

Property	Type	Default Value	Description
mergedCells	Array	[]	Used to define pre-merged cells. For the structure of the objects in this array please see below.

Merged cell object structure:

Property	Type	Optional/Mandatory	Description
row	Integer\|function(Integer)	Mandatory	If it's an Integer, it's the index of the row which have cells to be merged. If it's a function, it's a predicate to decide which rows are to be merged. It takes an integer (the row index), and should return true or false;
start	Integer	Mandatory	The column index of the left most cell that shall be merged.
end	Integer	Mandatory	The column index of the right most cell that shall be merged.
major handle	Integer	Optional	The column index of the cell whose content should be used as the content of the merged cell. It must be larger than or equal to the startColumnIndex, and less than or equal to the endColumnIndex. If it is omitted, the content of the leading edge (left-most for ltr, right most for rtl) cell will be used. If a "merged cell" structure is returned from getMergedCells/getMergedCellsByRow, this field is valid, so it can be used to unmerge the cells.

This plugin exposes the following methods to the grid:

mergeCells(rowTester, start, end, major):: Merge cells from startColumnIndex to endColumnIndex at rows that make rowTester return true, using the content of the cell at majorColumnIndex. Returns a merge handler, used to unmerge the cells. Please refer to "Merge cell object structure" for the detail of the arguments.
unmergeCells(mergeHandler): Unmerge the cells that are merged by the mergeHandler, which represents a call to the function mergeCells.
getMergedCells(): Returns an array of records of all merged-cells.
getMergedCellsByRow(rowIndex): Returns an array of records of currently merged cells at the given row.

Here is some examples on how to use this API:

And here is the effect of merged cells: