addSpan

добавляет объединение рядов и колонок в datatable

void addSpan(number|string|array id, [string column,number width,number height,string value,string css] );
idnumber|string|arrayID ряда, с которого начинается объединение колонок/рядов
columnstringID колонки, с которого начинается объединение колонок/рядов
widthnumberсколько колонок будет в объединении
heightnumberсколько рядов будет в объединении
valuestringданные, которые будут показаны в объединенных ячейках
cssstringкласс css для стилизации объединения

Available only in PRO Edition

Example

grid.addSpan(1, "country", 1, 3);
grid.refresh();

Details

Чтобы позволить пользователю объединять ячейки, используйте свойство spans:

webix.ui({
    view:"datatable",
    columns:[...],
    spans:true
    ...
});

Вместо отдельных параметров с настройками для объединения вы можете передать матрицу с теми же настройками (id, column, width, height, value, css), что особенно удобно, если вы хотите задать сразу несколько объединений:

grid.addSpan([
    [1, "country", 1, 3],
    [4, "country", 1, 2],
    [6, "country", 1, 3]
]);

Значения по умолчанию для параметров метода:

  • значения по умолчанию для width и height - 1;
  • параметр value задавать необязательно; он нужен чтобы изменить текст в ячейке после объединения. Если старый текст вас устраивает, но вы хотите передавать методу еще и третий параметр, передайте в value "" или null;
  • параметр css тоже необязательный. По умолчанию никакой особой стилизации у объединений нету.
See also
Наверх
If you have not checked yet, be sure to visit site of our main product Webix javascript dashboard framework and page of javascript data table product.