structure

задает настройки для Pivot (поля, операции, фильтры)

Example

webix.ui({
    view:"pivot",
    structure: { 
        "rows": ["form", "name"],
        "columns": ["year"],
        "values": [
            { "name": "gdp", "operation": "sum" },
            { "name": "oil", "operation": "sum" }
        ],
        "filters": [
            {
                "name": "continent",
                "value": {
                    "condition": {
                        "filter": "c",
                        "type": "notContains"
                    },
                    "includes": [
                        "Europe",
                        "Asia"
                    ]
                }
            }
        ]
    }
});

Related samples

Объект содержит следующие поля:

• rows (array) - массив рядов таблицы
• columns (array) - массив столбцов таблицы. Эквивалентно полю groupBy в режиме "chart"
• values (array) - массив с настройками значений. Каждый объект содержит следующие поля:
  • name (string) - название поля
  • operation (string, array) - название операции. Встроенной ("sum", "min", "max", "count", "avg", "wavg", "counta", "countunique", "median", "product", "var", "varp", "stdev", "stdevp", "any") или кастомной. Свойство принимает строку или массив строк
  • format (function) - форматирующая функция
  • color (string) - цвет для секций чартов
• filters (array) - массив полей для фильтрации. Описание свойств одного элемента фильтрации:
  • name (string) - название существующего поля
  • value (object) - значение фильтра:
    • condition (object) - включает тип условия и значение для фильтрации.
      Например: { condition: "contains", value: "a" }
      См. список поддерживаемых типов условий в API фильтра
    • includes (array | null) - необязательный параметр, массив явно выбранных значений. В зависимости от типа поля массив может содержать строковые или числовые значения (даты преобразуются в timestamps). Отсутствие этого свойства или null равнозначны выбору всех значений. Пустой массив снимает выбор со всех значений, и результат фильтрации будет пустым.
• groupBy (string) - название поля, по которому происходит группирование. Используется в режиме чарта. Эквивалентно полю columns в режимах "table" и "tree".

Как задать structure динамически

Т.к. это реактивное свойство, вы можете получить доступ к нему, а также изменить его значение динамически через состояние виджета:

$$("pivot").getState().structure = {/* новые настройки */};

Ещё один способ — вызов метода setStructure с объектом настроек в качестве параметра:

$$("structures").attachEvent("onItemClick", function(id) {
    var str = webix.copy(this.getItem(id).structure);
    $$("pivot").setStructure(str);
});

Как получить текущий structure

Вы можете получить текущие настройки через состояние виджета:

$$("pivot").getState().structure;

или же с помощью метода getStructure:

const structure = $$("pivot").getStructure();
/*
    {
        columns: ["year"],
        filters: [
            {
                name: "continent",
                value: {
                    condition: {
                        "filter": "c",
                        "type": "notContains"
                    },
                    includes: [
                        "Europe",
                        "Asia"
                    ]
                }
            }
        ],
        groupBy: "year",
        rows: ["form", 'name"],
        values: [{name: "oil", operation: "min", color: "#e33fc7"}, ...]
    }
*/