используется для настройки колонок таблицы
webix.ui({
view:"datatable",
columns:[
{ id:"rank", header:{ text:"#", rowspan:2}, width:50, css:"rank"},
{ id:"title", header:["Film title", {text:"Second line", colspan:3}]},
{ id:"year", header:["Year",""], width:80},
{ id:"votes", header:["Votes",""], width:100}
]
});
Один объект массива - настройки для одной колонки. У объектов могут быть следующие настройки:
| adjust | (string,boolean) используется для автоматического подсчета ширины колонки. Ширина колонки может подстроиться под:
Ширина колонки в любом случае не будет меньше, чем minWidth или больше, чем maxWidth, если что-то из этого задано. |
| adjustBatch | (number) ограничивает количество ячеек, из величины данных в которых будет идти автоматический расчет ширины всей колонки. |
| checkValue | (any) ненулевое значение для `common.checkbox()`/`common.radio()` |
| collection / options | (string, object, array, function, proxy) позволяет грузить значения для колонки (значения, фильтры и редакторы) из отдельного источника данных. |
| css | (string,object) стили CSS, которые будут присвоен колонке. css можно задавать как:
|
| cssFormat | (function) функция, которая принимает в качестве параметра значения из ячеек колонки и возвращает объект с правилами css (или имя класса css), которые будут применены к ячейке с этими значениями. Всего у функции 4 параметра:
|
| editor |
(string) редактор для значений в колонке. Может быть одним из этих значений:
|
| editaction |
(string) действие, по которому открывается редактор для значений в колонке. Может быть одним из следующих значений:
|
| editFormat | (function) функция, которая обрабатывает значение, которое отображается в редакторе во время редактирования. Используется для форматирования чисел. Подробнее |
| editParse | (function) функция, которая обрабатывает настоящее значение из редактора. Используется для форматирования чисел. Подробнее |
| fillspace | (number, boolean) Если fillspace:true, колонка займет все доступное пространство. Если fillspace есть более чем у одной колонки, они разделят доступное пространство поровну. Если fillspace задано числом > 1, колонки разделят доступное пространство пропорционально числам. |
| format | (function) форматирование данных |
| footer |
(string,array) задает футер для колонки. Если определено как массив, задает многострочный футер (каждый элемент массива может быть строкой или объектом с настройками).
Настройки у объекта могут быть такие:
|
| header |
(string,array) задает хедер для колонки. Если определено как массив, задает многострочный хедер (каждый элемент массива может быть строкой или объектом с настройками).
Настройки у объекта могут быть такие:
|
| hidden | (boolean) скрывает колонку во время инициализации |
| id | (string) ID колонки |
| liveEdit | (boolean) включает обновление данных во время их редактирования для всех колонок, в которых используется редактируемые данные |
| math | (string) задает формулу для подсчета значений по всей колонке |
| minWidth | (number) задает минимальную ширину колонки (влияет на ресайз и динамическую ширину, выставленную fillspace). |
| maxWidth | (number) задает максимальную ширину колонки (влияет на ресайз и динамическую ширину, выставленную fillspace) |
| numberFormat | (string) задает формат для чисел (настройка для редактора). Подробнее |
| resize | (boolean) defines whether the column can be resized |
| sort |
(string,function) включает сортировку для колонки с указанием типа данных (сортирует данные по клику на хедер).
Типы данных:
|
template |
(string,function) темплейт для данных в этой колонке
Если темплейт задан как функция, у нее будут следующие параметры: |
| uncheckValue | (any) нулевое значение `common.checkbox()`/`common.radio()` |
| width | (number) фиксированная ширина колонки |