Плагин findform

Плагин для вывод панели (findform) с быстрым поиском для списка. Документация по плагину находиться на docs.appcode.pw

Применение:

Для компонента, который является наследником от IServ.UI.Classic.ListViewPanel, добавляется плагин findform

Ext.define('Core.view.sys_users.sys_users-listview', {
    extend: 'IServ.UI.Classic.ListViewPanel',
    ...
    plugins: [{
        ptype: 'findform',
        isVisibleOnStartup: true, (1)
        ignoreEmpty: true, (2)
        resetMode: 'reset', (3)
        onlyValue: false, (4)
        formConfig: { (5)
            xtype: 'sys_users-findform',
            width: 500
        }
    }], 
...

Описание плагина

(1) Свойство isVisibleOnStartup предназначено для отображения панели с поиском при старте или нет. По умолчанию значение установлено в false. Для управления видимостью панели через код можно применить следующее:

// находим нашу панель (Core.view.sys_users.sys_users-listview) со списком
var listview = getListView();
listview.findFormVisible(true|false);

У панели со списком после применения плагина появляется новый метод findFormVisible, который принимает один аргумент типа boolean

(2) Свойство ignoreEmpty позволяет отфильтровывать пустые значения из формы и не передавать их на сервер. По умолчанию значение false

// фильтр у формы
[
    {
        "property": "login",
        "value": "user"
    },
    {
        "property": "name",
        "value": ""
    }
]
// если свойство ignoreEmpty=true, то результат будет таким
[
    {
        "property": "login",
        "value": "user"
    }
] 

(3) Свойство resetMode указывает какой механизм очистки данных, при нажатии на кнопку «Очистить», применять. По умолчанию установлено значение «clear»

• clear — очищает список
• reset — сбрасывает значения у формы по умолчанию и делает запрос на загрузку данных хранилищу

(4) Свойство onlyValue предназначено для формирования фильтра без указания логики. Механизмом фильтрации занимается сервер. По умолчанию значение false (см. раздел Генерации формы — способ № 3)

(5) Свойство formConfig предназначено для настройки формы фильтрации. Главным свойство данного параметра является xtype. В нем указывается какая форма должна выводиться для поиска. Параметр width указывает ширину панели

В formConfig можно указать фильтр для запроса (его можно указать и в самой форме см. раздел Генерации формы — способ № 2)

formConfig: {
    xtype: 'simplefindform',
    // для кастомного переопределения условия фильтра
    getFilter: function() { 
        return [{ property:"login", value: "admin" }]
    }
}