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 lightweight js framework and page of javascript excel product.