addSpan
adds a colspan or a rowspan to the datatable
void addSpan(number|string|array id, [string column,number width,number height,string value,string css] );
number|string|array | the id of the row that starts colspan/rowspan | | column |
string | the id of the column that starts colspan/rowspan | | width |
number | how many columns should the span include | | height | number | how many rows should the span include |
| value | string | value that the span area should display |
| css | string | css class that should be applied to the span area |
Available only in PRO Edition
Example
grid.addSpan(1, "country", 1, 3);
grid.refresh();
Details
To enable the rowspans and colspans functionality, you should set the spans parameter to true in the datatable configuration:
webix.ui({
view:"datatable",
columns:[...],
spans:true
...
});
The method can also take an array of arrays with the same configuration (id, column, width, height, value, css) to define several spans at a time.
grid.addSpan([
[1, "country", 1, 3],
[4, "country", 1, 2],
[6, "country", 1, 3]
]);
Defaults:
- default values for span width and height are 1;
- span value parameter is optional and used if a custom text for the cell is required. If you need to display the initial value, omit this field or pass an empty value ("", null);
- span css is optional. By default, colspans and rowspans don't feature any special styling.
See also
Back to top
Join Our Forum
We've retired comments here. Visit our forum for faster technical support,
connect with other developers, and share your feedback there.