Перейти к основному содержимому
Версия: 7.0

Фильтры и тулбар в React

Представление React может рисовать пользовательские фильтры, группы фильтров и тулбар группы объектов или дерева: их состояние оно читает в узле группы или дерева в props.data, а меняет его членами этой группы или дерева в props.controller. Те из них, что дизайн оставляет платформе, она рисует по-прежнему, в том числе над строками, которые рисует представление. Представление, которое рисует строки группы вне дерева, может также попросить сервер фильтровать их по собственным условиям — фильтрам представления группы.

Пользовательские фильтры​

filters — список условий пользовательского фильтра группы в порядке применения: условия, по которым сервер фильтрует группу, вместе с изменениями, которые ждут отправки: в ручном режиме применения — теми, что ждут применения, а в любом режиме — значением, которое подготовила панель платформы (значение F3), пока его не зафиксировал её редактор. Это отдельная часть группы, как её строки и её панельные свойства, и она лежит в узле группы там, где её компонент, — там, где стоит FILTERS(<group>): внутри бокса группы, где строки рисует и custom на BOX(<group>), или в самом FILTERS(<group>), если у него свой custom. Там поле есть всегда и пусто, когда группа не отфильтрована; в узле группы в любом другом контейнере его нет. У группы в виде PANEL его нет нигде: платформа и сама не показывает ей пользовательских фильтров. Каждое условие — объект:

ПолеЗначение
propertyИнтеграционный SID фильтруемого свойства — единственного свойства группы с этим именем, где бы оно ни рисовалось; в узле дерева — вместе с именем его группы, как ниже
compareОперация сравнения: =, >, <, >=, <=, !=, _ (содержит), @ (совпадение)
valueЗначение, с которым сравнивается, сконвертированное как любое значение свойства
negationОтрицание условия
orПрисоединяется ли условие к следующему через ИЛИ, а не И — то есть or у первого из двух делает пару дизъюнкцией

Это та форма записи, которую читает оператор FILTER, поэтому условие описывается одинаково в .lsf и в проекции; FILTERS пишет её же, только значение — строкой, а or — лишь у условия, соединённого через OR. Отличается только имя: FILTER называет свойство его именем на форме, проекция — его интеграционный SID, и это разные имена, если у свойства есть EXTID.

Условие называет свойство группы, а не запись узла: область фильтров не обязана быть там, где рисуется хоть одна колонка группы. Поэтому имя, которое группа рисует дважды, — колонка price и панельное свойство price в другом контейнере, — не называло бы никакого условия, и форма, пользовательские фильтры которой рисует React-представление, не строится, пока им не заданы явные EXTID.

data.<g>.properties перечисляет записи того узла, в котором лежит, поэтому в узле, где только пользовательские фильтры, он пуст: условие называет свойства группы, а не узла, — их перечисляет filterProperties.

Контроллер принимает условие в той же форме, поэтому спроецированное условие можно передать ему как есть. То, чего условие не указывает из compare, negation и or, читается так, как сказано ниже: в массиве — как у нового условия: сравнение свойства по умолчанию (его defaultCompare в filterProperties), без отрицания, И; в одиночном вызове — как у условия, место которого оно занимает. Исключение — условие на файловом свойстве: его value — ссылка на файл, а не файл, с которым сравнивает условие, поэтому такое условие со значением контроллер отклоняет, а без значения читает так же, как любое другое без значения.

controller.<group>.filters.change(condition) — член группы там, где filters, — меняет одно условие, не трогая остальные условия группы и их порядок: встаёт на место ПЕРВОГО условия по тому же свойству — диапазон это два условия по одному свойству, и вторая его граница остаётся, — сохраняя то, чего не указывает, из сравнения, отрицания и or этого условия; если такого нет — встаёт на место фильтра по этому свойству, если он у группы есть, а иначе добавляется в конец, в обоих случаях со сравнением свойства по умолчанию. Так {property: 'price', value: 300} превращает price > 100 ИЛИ … в price > 300 ИЛИ …. Условие без value — поля нет, оно null, '' или значение, которое тип читает как NULL: false свойства BOOLEAN (у TBOOLEAN false — значение), — снимает это первое условие, и только его. Так же задаёт значение change фильтра по свойству и F3 в гриде над условиями, которые рисует представление (Пользовательская панель фильтров), но эти двое, когда условия по свойству нет, сравнивают так, как его фильтр сравнивал в последний раз, а F3 на пустой ячейке задаёт условие сравнения с NULL: раз FILTER — пользовательский фильтр, заданный заранее, его значение и условие, добавленное вручную, задаются по одному правилу.

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

export function ItemBoard(props) {
const items = props.data.i;
const search = items.filters.find(f => f.property === 'name');
return (
<div>
<input value={search ? search.value : ''} placeholder="имя содержит"
onChange={ev => props.controller.i.filters.change({ property: 'name', compare: '_', value: ev.target.value })}/>
<ul>{items.list.map(row => <li key={row.key}>{row.name.value}</li>)}</ul>
</div>
);
}

Пустой ввод снимает условие по name — первое, которое показывает ввод, — сохраняя остальные условия: его value — '', то есть значения нет.

filters следует за списком группы — каким его меняют и каким его сообщает сервер, например список, заданный действием FILTER, — и пересобирается только тогда: массив сохраняет идентичность между рендерами, в которых его условия никто не задавал заново, — изменение значения свойства, строк или текущего объекта оставляет его прежним, — поэтому представление может сравнивать его между рендерами и мемоизировать по нему.

Изменение через контроллер попадает в список группы, и filters показывает его тут же. Отправляется оно сразу, ещё до того, как придут отфильтрованные строки, — кроме ручного режима применения, где оно, как и изменение панели фильтров платформы, ждёт применения; пока на него нет ответа, список, который сервер сообщает для группы в ответе на более ранний запрос, его не заменяет. Представление, которое отправляет поиск только после паузы в наборе, держит набираемое в собственном состоянии и вызывает change, когда пауза наступает.

После смены фильтров или сортировок сервер читает строки вокруг текущей строки, как в таблице платформы.

controller.<group>.filters.change(conditions) — то самое, что проекция зовёт data.<group>.filters, меняемое там же, где читается, — заменяет список сразу: массив задаёт все условия, которые представление может назвать, — условие по свойству, которому у него нет имени (ниже), остаётся на своём месте, — одиночное условие — одно. Для очистки того, что представление может назвать (controller.i.filters.change([]), — resetFilters() управляющих элементов фильтров сразу очищает все условия), или когда вид действительно владеет всем набором условий. Массив — это список условий, как его читает FILTER в .lsf: элемент без value — условие сравнения с NULL («пусто», с negation — «не пусто»), поэтому условие, которое filters перечисляет со значением null, — например, заданное F3 на пустой ячейке, — принимается обратно как есть, и условие свойства BOOLEAN тоже: оно перечисляется как false, а false читается обратно как NULL. Свойство, по которому больше не фильтруют, массив просто не включает.

Обе формы вызова change сообщают об ошибке автора, а не отбрасывают условие: неизвестное свойство, неизвестная операция сравнения или IN ARRAY (так условие не сравнивает), неизвестное поле условия, negation или or не булевого типа, условие на действии или на свойстве, сгруппированном по колонкам.

Условие, заданное иначе, не перечисляется, когда оно на свойстве без интеграционного SID (NOEXTID), которому у проекции нет имени, на действии, по которому форму не фильтруют, или на свойстве, сгруппированном по колонкам, ведь условие здесь называет свойство, а не одну из его колонок. Что и почему, говорит консоль.

Поэтому, если вернуть в форму-массив data.<group>.filters, эти условия останутся на своих местах, как и изменение ОДНОГО условия не трогает условий других свойств.

У дерева один бокс фильтров на все его группы, FILTERS(TREE <tree>), и его пользовательские фильтры лежат в узле дерева. filters там перечисляет условия всех его групп, сначала условия верхних групп, и называет каждое свойство именем его группы и его собственным, c.name, как <Platform> называет свойство группы. controller.<tree>.filters.change принимает условие, названное так же: имя читается до первой точки — имени группы, в котором точки нет, — а EXTID с точкой, который может быть у свойства, рисуемого платформой, принимается обратно таким, каким его даёт filters. Список, который он задаёт, — список дерева: controller.t.filters.change([]) одним запросом очищает условия всех его групп, которые может назвать, а одно условие вливается в условия их всех.

Рядом с filters пользовательские фильтры говорят, на чём может быть условие, — filterProperties, данные дизайна, есть с самого начала: свойства группы, которые может называть условие, где бы они ни были нарисованы, в порядке формы, — в узле дерева свойства всех его групп, сначала свойства верхних групп. Каждое — объект:

ПолеЗначение
propertyСвойство, названное так, как его называет условие
captionЕго подпись в дизайне, null, если дизайн её не задаёт
typeТип значения условия: string, number, date, boolean или json — тип ФИЛЬТРА, по которому читается и пишется value
comparesСравнения, которые для него предлагает штатный редактор фильтров, в том же написании, что и в filters
defaultCompareТо, с которого этот редактор начинает: названное дизайном, и оно не обязательно входит в compares

Действия, свойства в колонках и свойства без интеграционного SID не перечисляются: условия на них быть не может. Не перечисляется и файловое свойство: условие на нём всё так же перечисляется в filters, и его можно задать только без значения, как сказано выше.

Управляющие элементы фильтров​

Управляющие элементы фильтров, которые рисует представление, одинаковы, кто бы ни рисовал условия, — само представление, получающее filters, или панель платформы, FILTERS(o), размещённый обратно с custom = NULL, — и каждый делает то же, что там делает кнопка платформы:

в узлечленнад условиями представлениянад панелью платформы
addFilter()ставит то же условие, что и F3новое условие на той же ячейке с открытым редактором, как «добавить» панели, — или значение ячейки в фильтре по свойству, который рисует представление на этой колонке, если тот не показывает условия
filtersPending, filtersManualapplyFilters()отправляет то, что ждёт, — ничего, если ничего не ждётто же самое, вместе с введёнными условиями
resetFilters()очищает списоксбрасывает условия панели

filtersManual — ручной режим применения: включена настройка, при которой пользовательские фильтры применяют изменения вручную (userFiltersManualApplyMode), — у управляющих элементов, которые рисует представление, кнопка применения есть всегда, у элементов платформы — пока они показаны, а показывает их кнопка фильтров тулбара. В этом режиме изменение условий группы ждёт применения, кто бы его ни задал, — представление, фильтр по свойству, F3, панель платформы; сброс всё равно уходит сразу, как и детализация сводной таблицы и строка, которую удаляет панель платформы. Применение отправляет список группы таким, какой он есть: значение, набранное в редакторе, который рисует представление, и хранящееся в собственном состоянии представления, в список не входит, пока представление его не задаст (filters.change, change фильтра по свойству), поэтому представление задаёт такое значение до применения, иначе применение его не отправит. filtersPending — ждёт ли что-нибудь: список отличается от отправленного — в ручном режиме применения до применения, а в любом режиме — пока панель платформы держит подготовленное значение (значение F3), которое её редактор ещё не зафиксировал. По умолчанию настройка выключена: изменение отправляется сразу, filtersManual остаётся false, и представление может вовсе не рисовать FILTERCONTROLS(o) — группа фильтруется так же. Где условия рисует и само представление, resetFilters() сразу очищает их все, в том числе условия по свойствам, которым у представления нет имени, а filters.change([]) очищает те, что оно может назвать, и отправляется, как любое изменение: члены двух компонентов могут делать почти одно и то же — часть каждого компонента повторяет свой компонент.

function ItemFilterButtons({data, controller}) {
const items = data.i, buttons = controller.i;
return <div>
<button onClick={() => buttons.addFilter()}>+</button>
{items.filtersManual &&
<button disabled={!items.filtersPending} onClick={() => buttons.applyFilters()}>Применить</button>}
<button onClick={() => buttons.resetFilters()}>Сбросить</button>
</div>;
}

Ячейка, на которой добавляется условие, — текущая ячейка штатного грида, где строки рисует платформа, и первая колонка, которую несёт представление и показывает форма и на которой может быть условие, — текущей колонки у него нет — в его текущей строке, где строки рисует оно. У дерева это текущая ячейка штатного дерева или первая колонка группы текущего узла, которую показывает форма и на которой может быть условие, в текущей строке этой группы. Без FILTERS(o) в дизайне addFilter отклоняется — у платформы нет такой кнопки.

Внутри пакета команды входят в него, как filters.change.

Группы фильтров​

Группа фильтров, которую рисует представление, лежит в узле своей группы под своим именем, в форме записи свойства:

FORM items
OBJECTS i = Item
FILTERGROUP stock
FILTER 'В наличии' balance(i) > 0 'F10' DEFAULT
FILTER 'Нет в наличии' balance(i) <= 0
;
// data.i.stock
{value: 0, filters: ['В наличии', 'Нет в наличии'], canClear: true}

controller.i.stock.change(1); // выбрать «Нет в наличии»
controller.i.stock.change(null); // ни одного — как «(Все)» платформы
ПолеЗначение
valueИндекс выбранного фильтра в filters, null — ни одного
filtersПодписи фильтров в порядке дизайна
canClearМожно ли не выбрать ни одного — как это предлагает виджет платформы: группа из одного фильтра — её флажок, он снимается всегда; группа из нескольких — её список, с «(Все)», если нет NONULL. Где false, change(null) отклоняется

Выбранный фильтр применяет и сообщает сервер, поэтому value — то, что держит сервер: фильтр по умолчанию при открытии формы, выбор действия FILTERGROUP, — а фильтр, выбранный представлением, показывается сразу. change принимает индекс одного из filters или null, а остальное отклоняется. Он входит в пакет, как и filters.change, и обращается к серверу даже за показанным фильтром — после упавшего пакета тот задаётся заново. Клавиша фильтра продолжает работать, пока форма показывает группу фильтров — hidden её дескриптора — и показано представление, которое её рисует, вместе с хостом, в который это представление размещает контейнер, так, как её понимает виджет платформы: выбирает фильтр, а в группе из одного фильтра — флажке платформы — нажатая снова снимает его.

Группа фильтров принадлежит своей группе — последней для объектов, которые принимают её фильтры, той, к которой применяется фильтр формы, — в том числе группе дерева: она лежит в узле этой группы, data.<group>.<filterGroup>, а не в узле дерева, где лежит то, что у платформы одно на всё дерево, — его пользовательские фильтры, управляющие элементы фильтров, тулбар и сортировки, — хотя дизайн платформы ставит группы фильтров дерева в его FILTERGROUPS(TREE <tree>).

Фильтры по свойствам (FILTER)​

У свойства, объявленного пользовательским фильтром, — PROPERTIES(i) name FILTER или USER в блоке фильтров, — есть свой фильтр среди пользовательских фильтров его группы: компонент, который дизайн называет FILTER(name(i)), по имени свойства на форме, а панель фильтров платформы показывает строкой условия с самого открытия формы, если компонент и все содержащие его контейнеры остаются в дизайне формы. Фильтр по свойству, который рисует представление, — часть группы своего свойства там, как группа фильтров: в узле группы, в filter, по интеграционному имени свойства — один объект на фильтры, которые рисует представление, без прототипа, как byKey:

FORM items
OBJECTS i = Item
PROPERTIES(i) name FILTER, price
;

DESIGN items {
NEW search FIRST {
custom = 'ItemSearch';
MOVE FILTER(name(i));
}
}
// data.i.filter.name
{caption: 'Наименование', type: 'string', active: false, compare: '_', negation: false, or: false, value: null}

controller.i.filter.name.change('ab'); // отфильтровано по нему
controller.i.filter.name.change('ab', {negation: true}); // ... по его отрицанию
controller.i.filter.name.change(null); // ... и больше нет
ПолеЗначение
captionЗаголовок свойства в дизайне, null, если дизайн его не задаёт
typeТип значения условия: string, number, date, boolean или json — тип FILTER, по которому читается и пишется value
activeЕсть ли у фильтра условие — в том числе условие сравнения с NULL, у которого value, как и без условия, — null (у свойства BOOLEAN — false)
compare, negation, orСравнение условия фильтра, записанное так же, как в filters, отрицание условия и соединено ли оно со следующим по ИЛИ, как это говорит filters; пока условия нет — те, что были у условия, которое он показывал последним, а поначалу — сравнение свойства по умолчанию, false и false
valueЗначение условия фильтра, null, пока условия нет

Условие фильтра — первое условие по его свойству среди пользовательских фильтров группы, как строка фильтра в панели платформы берёт первое условие по своей колонке, кто бы его ни задал: фильтр, filters.change, панель фильтров платформы, действие FILTER. change(value, options) задаёт его значение так же, как filters.change задаёт одно условие: на месте этого условия или, если условия нет, на собственном месте фильтра. Параметры {compare, negation, or}, любые из них, задают сравнение условия — записанное так же, как в filters, — его отрицание и связку, как строка платформы при показанных управляющих элементах фильтров. Неуказанные параметры остаются такими, как у фильтра: как у его условия, а без условия — как он сравнивал в последний раз (выше). Параметр, которого change не знает, сравнение, которым условие сравнивать не может, — неизвестное или IN ARRAY, — и отрицание или or, отличные от true и false, отклоняются, и без значения тоже — тогда ничего не снимается. Без значения — отсутствующего, null, '' или такого, которое тип читает как NULL: false свойства BOOLEAN, — снимает это условие, что бы ни говорили параметры, и только его: вторая граница диапазона остаётся и становится тогда условием фильтра, как при очистке строки платформы. Сам фильтр никогда не удаляется. В пакете идёт с пакетом, как filters.change. Условие фильтра по файловому свойству можно только снять: его value — ссылка на файл, а не файл, с которым сравнивает условие.

Фильтра по свойству без условия в filters нет, но он сохраняет своё место среди условий группы, и заданное ему условие встаёт на это место: при открытии формы эти места — первые, в порядке объявления. or связывает условие со следующим в filters, пропуская такие места. Замена всего списка — через filters.change([...]) или действием FILTER — переносит их после своих условий.

Фильтр по свойству не зависит от того, кто рисует условия группы: представление, которое его рисует и тогда получает и filters, или другое представление, или панель фильтров платформы, — его условие в любом случае одно из списка группы и отправляется, как любое изменение: сразу или, в ручном режиме применения, при применении; фильтр показывает изменение и до этого. Над панелью платформы фильтр — её же строка, которую рисует представление: своей строки для него панель не показывает. Когда клавиши фильтров таблицы подставляют значение в эту строку, редактор не открывается: её рисует React. Пока строка не показывает условия, Alt+F3 и «добавить» управляющих элементов фильтров на этой колонке тоже кладут в неё значение ячейки, а набор там ничего не начинает. Когда условие у неё есть, «добавить» и набор начинают новую строку панели. Фильтр по свойству группы дерева лежит в узле своей группы, как группа фильтров группы дерева. Его запись, data['FILTER(name(i))'], говорит, показывает ли форма фильтр, — его SHOWIF или контейнера над ним.

Фильтр по свойству с custom = NULL — платформы: её строка пользовательских фильтров группы, как её показывает обычная форма, которую представление размещает через <Platform name="FILTER(name(i))"/>, как любой дочерний компонент, который рисует платформа (размещение). Это та же строка, кто бы ни рисовал условия группы, — панель фильтров платформы или представление, над условиями которого она — единственная строка, которую рисует платформа, — и так же рисуется фильтр по свойству, стоящий вне React:

DESIGN items {
FILTERS(i) { custom = 'ItemFilters'; } // условия: представление
FILTER(name(i)) { custom = NULL; } // ... и строка платформы для фильтра по имени, её размещает представление
}

Значение, введённое в строке, — значение фильтра и отправляется, как любое изменение. Условие, которое представление задаёт по этому свойству, показывается в ней. Для F3 над условиями представления свойство должно быть в filterProperties либо быть файловым (Пользовательская панель фильтров). Где тулбар выключает фильтры платформы (showFilters = FALSE), такой фильтр не рисует никто, как в форме без React-представления. Фильтр с собственным компонентом React — FILTER(name(i)) { custom = 'NameSearch'; } — рисует свою часть в собственном представлении (Собственное представление компонента).

Некоторые сочетания отклоняются при построении формы:

  • фильтр группы в виде PANEL, у которой нет пользовательских фильтров: и тот, что рисует представление, и тот, которому в представлении задан custom = NULL;
  • фильтр, который рисует представление, по свойству, которое его условие не может назвать или дать ему значение: без интеграционного имени (NOEXTID), сгруппированному в колонки, действию;
  • фильтр, который рисует платформа над условиями представления, по действию, по которому не фильтруют.

Пользовательская панель фильтров​

Генерируемые боксы группы — FILTERS(o), FILTERBOX(o), FILTERGROUPS(o), TOOLBARBOX(o), TOOLBARLEFT(o), TOOLBARRIGHT(o), TOOLBAR(o), POPUP(o), PANEL(o) — обычные контейнеры, поэтому каждый из них принимает custom. Компонент на одном из них подменяет только эту часть: строки продолжает рисовать штатный грид, а остальное в боксе остаётся платформе.

DESIGN items {
FILTERS(i) { custom = 'FilterPanel'; }
}

Такой компонент строк группы не рисует — их по-прежнему рисует платформа, — но пользовательские фильтры — его часть: props.data.<g> — узел группы в нём, с filters, с тем, на чём может быть условие (filterProperties), и без всего, что относится к строкам.

Своих условий платформа для такой группы не рисует, но её команды фильтров таблицы действуют над условиями, которые рисует представление, — списком группы, который компонент видит в filters:

  • кнопка фильтров в тулбаре показывает и прячет управляющие элементы, которые платформа рисует в FILTERCONTROLS(o). Их сброс очищает список, а добавление делает то же, что F3. Если бокс компонента включает и FILTERCONTROLS(o), их рисует компонент: это его управляющие элементы фильтров, чьи resetFilters() и addFilter() делают то же самое, а кнопка фильтров в тулбаре есть, только если платформа рисует строки фильтров по свойствам, — она показывает и прячет их селекторы;
  • F3 сразу задаёт значение текущей ячейки, в том числе в фильтре по свойству, без подтверждения в редакторе платформы: его правит компонент. Alt+F3 использует для нового условия сравнение по умолчанию. Изменение отправляется сразу или, в ручном режиме применения, при применении. Условие не начинается ни там, где текущей строки нет, — в пустом гриде, в сводной таблице, на карте, в календаре или пользовательском представлении, у которых нет ячейки, — ни на ячейке, свойства которой нет в filterProperties — кроме ячейки файлового свойства: F3 задаёт условие и на ней, а представление задаёт такое только без значения, — или которая показывает не то значение, по которому её свойство фильтруется;
  • набор в колонке условия не начинает. Быстрый поиск грида сохраняется. Кнопка применения — у управляющих элементов фильтров: платформы в FILTERCONTROLS(o), пока они показаны, или компонента, если их рисует он, — в ручном режиме применения изменение ждёт её.

Фильтры по свойствам, которые дизайн объявляет в боксе, — этого компонента: он рисует их как фильтры по свойствам.

Эти команды есть везде, где представление рисует бокс FILTERS группы в виде LIST, что бы ни говорил её TOOLBARSYSTEM(o): showFilters, как и остальные флаги show… тулбара, — только платформенный и выключает только то, что платформа рисует из фильтров: её панель, её управляющие элементы в FILTERCONTROLS и кнопку фильтров тулбара. При showFilters = FALSE и условиях, которые рисует представление, управляющие элементы фильтров представления и клавиши грида работают как обычно; при условиях платформы команд нет, и члены управляющих элементов, которые рисует представление, отказывают. Команды дерева те же — над условиями всех его групп, filters его узла, — и так же действует showFilters его тулбара.

props.controller.<g>.filters их меняет, поэтому панель и показывает текущие условия, и выставляет их: поле поиска из ItemBoard, без списка, и есть такая панель.

Условия, которые выставляет компонент, — это условия самой группы: действие FILTER, детализация сводной таблицы и этот компонент меняют один список и разойтись не могут.

TOOLBARSYSTEM(o), FILTERCONTROLS(o), FILTERGROUP(f) и фильтр по свойству FILTER(name(o)) не контейнеры, но каждый принимает собственный custom, и тогда на его месте рисует React-компонент (Собственное представление компонента).

То, что компонент получает состояние группы, не делает его единственным, кто это состояние рисует. Что рисуется, решают дизайн и размещение через <Platform>, а не содержимое data: состояние принадлежит группе, кто бы его ни рисовал.

Компонент на соседнем с FILTERS(o) боксе — например, TOOLBARLEFT(o) — части фильтров не получает: в узле группы там, если он есть, filters нет.

Фильтры представления​

Представление, которое рисует строки группы вне дерева, может попросить сервер фильтровать их по собственным условиям — фильтрам представления группы, как календарь фильтрует свою группу по периоду, который показывает. Это список, отдельный от пользовательских фильтров группы, которые меняет пользователь и задаёт действие FILTER, и сервер применяет его вместе с ними, с собственными FILTERS формы и с её группами фильтров. viewFilters перечисляет их рядом с list и keys, там, где рисуются строки: поле есть всегда и пусто, пока представление не задало ни одного условия. Каждая запись — условие в той форме, в какой его даёт filters, — property, compare, value, negation, or, — на свойстве группы, названном так же, где бы оно ни рисовалось.

controller.<group>.viewFilters.change(conditions) — член ровно там же и только там — заявляет список целиком, массивом, который читается как массив у filters.change: то, чего условие не задаёт из compare и negation, берётся по умолчанию, а условие без value сравнивает с NULL. Пустой массив снимает все условия. Условия применяются все вместе, поэтому условие с or: true отклоняется, как и всё, что отклоняет в условии filters.change.

export function MeetingList({data, controller}) {
const meetings = data.e;
const show = first => controller.e.viewFilters.change([ // встречи одного месяца: два условия на дату
{property: 'date', compare: '>=', value: first},
{property: 'date', compare: '<', value: new Date(first.getFullYear(), first.getMonth() + 1, 1)}
]);
const stated = meetings.viewFilters[0]; // заданное представлением читается обратно из проекции
return (
<div>
<button onClick={() => show(new Date(2031, 0, 1))}>Январь</button>
<button onClick={() => show(new Date(2031, 1, 1))}>Февраль</button>
<button onClick={() => controller.e.viewFilters.change([])}>Все</button>
<span>{stated ? 'с ' + stated.value.toLocaleDateString() : 'все встречи'}</span>
<ul>{meetings.list.map(row => <li key={row.key}>{row.name.value}</li>)}</ul>
</div>
);
}

Изменение через контроллер отправляется сразу, всем списком группы, и viewFilters показывает его тут же, ещё до того, как придут отфильтрованные строки. Сервер фильтры представления не сообщает, поэтому viewFilters — то, что вызов задал последним: поле перестраивается только вызовом, а между ними сохраняет идентичность от рендера к рендеру, и после запроса, который не удался, по-прежнему перечисляет заданное этим запросом — там, где это важно, задайте список заново. Размер страницы с ними не передаётся: у группы остаётся тот, что дала форма (PAGESIZE).

Фильтры представления принадлежат тому представлению, которое рисует строки. Другой контейнер задаёт их через контроллер формы, controller.form.changeViewFilters('<group>', conditions) (между контейнерами); для группы, строки которой рисует платформа, вызов отклоняется — виды отображения, в которых таблица платформы показывает такие строки, задают собственные фильтры: календарь — период, который он показывает, — как и для группы дерева.

Тулбар​

Где тулбар группы рисует представление, то, что показывают его кнопки, лежит в узле группы, props.data.<g>, а сами кнопки — члены группы, в props.controller.<g>. Своего тулбара для группы платформа тогда не рисует, и над своим гридом тоже. Шапка представления над штатным гридом:

DESIGN items {
NEW header FIRST {
custom = 'ItemHeader';
MOVE TOOLBARSYSTEM(i); // грид остаётся платформенным, тулбар — у представления
}
}

Каждый член и то, что показывает его кнопка, есть, что бы ни говорили флаги дизайна, — showFilters, showViews, showCalculateSum, … только платформенные, по ним рисуется её собственный тулбар; представление рисует то, что хочет, — как и имя, которое каждый занимает в узле: там, где тулбар рисует представление, ни одно свойство группы не займёт getSum, что бы ни говорил showCalculateSum. visible — не из этих флагов: тулбар, который дизайн прячет (visible = FALSE), не часть ни одного представления — в узле от него ничего нет, членов нет, имён он не занимает.

в узлечленчто делаеткнопка платформы
manualmanual.change(on)включает или выключает ручное обновлениеручное обновление
updatePendingupdate()подтягивает изменения, которые сервер придерживает при ручном обновленииобновить
filterControlsVisiblefilterControlsVisible.change(shown)показаны ли управляющие элементы фильтров платформы — кнопки её FILTERCONTROLS и редакторы условий её панели FILTERS и строк фильтров по свойствам, которые она рисует; на панели без условий — с условием для заполнениякнопка фильтров
listView, listViewslistView.change(name)показывает строки таблицы платформы в другом виде отображения — одном из listViews: grid, pivot, а также custom, map или calendar, где они у группы естьпереключатель вида отображения
getCount()число строк группы — только отмеченных, если пользователь их отметил, как считает платформа, — Promise ответа сервера, запрос, как getValuesколичество
getSum(property)сумма колонки — только по отмеченным строкам, если пользователь их отметил, как суммирует платформа, — Promise: числовое свойство группы, названное так, как его называет сортировка, не разложенное по колонкамсумма — текущей колонки, которой у представления нет, поэтому её называет вызов
export()выгрузка строк группы в Excel — серверный отчёт по нимэкспорт — на сводной таблице выгружающий её саму

То, на что действуют кнопки, — платформенное: filterControlsVisible показывает и прячет управляющие элементы фильтров — кнопки FILTERCONTROLS, редакторы и селекторы строк фильтров по свойствам ПЛАТФОРМЫ, и где у платформы их для группы нет — она не рисует ни панели FILTERS(o), ни FILTERCONTROLS(o), ни строк фильтров по свойствам, потому что их рисует представление, или дизайн удаляет сами компоненты либо содержащий их контейнер, или тулбар выключает фильтры платформы (showFilters = FALSE), — он остаётся false, а его изменение отклоняется с объяснением причины. Свои управляющие элементы представление показывает само — это его управляющие элементы фильтров. Переключатель вида отображения переключает таблицу платформы: где строки рисует представление, listViews пуст, listView равен null, а изменение отклоняется. У группы, строки которой рисует представление, тип вида списка — GRID по умолчанию. Грид группы, которой форма задаёт другой (OBJECTS o = Order PIVOT, а также MAP, CALENDAR, CUSTOM), рисует платформа в этом виде, а React-контейнер вокруг него размещает грид через <Platform name="GRID(o)"/>, как и грид с custom = NULL. custom у самого грида (GRID(o) { custom = 'OrderCards'; }) — это CUSTOM группы, и он задаёт группе вид CUSTOM (Компонент React в CUSTOM).

export(), update(), manual.change() и listView.change() тулбара возвращают Promise своего запроса. Внутри пакета члены, которые обращаются к серверу, возвращают отвергнутый Promise с причиной отказа. Настроек таблицы платформы здесь нет — это её диалог над таблицей, которую она рисует. Тулбар, размещённый обратно с custom = NULL, их сохраняет.

Тулбар и управляющие элементы фильтров дерева​

У дерева один тулбар и один набор управляющих элементов фильтров на все его группы — TOOLBARSYSTEM(TREE t) и FILTERCONTROLS(TREE t). Где их рисует представление, они лежат в узле дерева data.t, кто бы ни рисовал строки дерева:

DESIGN catalogue {
NEW header FIRST {
custom = 'CatalogueHeader';
MOVE TOOLBARSYSTEM(TREE t); // дерево остаётся платформенным; его тулбар — представления
}
}

Кнопки тулбара штатного дерева становятся членами тулбара, что бы ни говорили его флаги show… — они только платформенные, как у тулбара группы, — а две, раскрывающие дерево, — только там, где строки дерева рисует платформа:

в узлечленчто делаеткнопка платформы
filterControlsVisiblefilterControlsVisible.change(shown)показаны ли управляющие элементы фильтров дерева платформы, как в тулбаре группыкнопка фильтров
export()выгружает дерево в Excel — отчёт сервера по немуэкспорт
expandCurrent()над штатным деревом: раскрывает его выделенный узел и все узлы под ним — только узел с детьми«Развернуть текущий объект»
expandTree()над штатным деревом: раскрывает все узлы группы выделенного узла под раскрытыми узлами выше и групп под ней — всё дерево, когда выделен узел верхней группы«Развернуть всё дерево»

Где строки дерева рисует представление, этих двух в тулбаре нет: дерево раскрывается членами, которые у него уже есть, — текущий узел собственным expandCurrent() дерева, в том же узле, где представление рисует и то и другое, дерево от группы вниз — expandAll() этой группы (всё дерево — верхней), — по одному члену на каждое действие. Поэтому то, какие члены раскрывают дерево, зависит от того, кто рисует его строки, и у представления, которое рисует тулбар дерева в другом контейнере, чем строки дерева, их там нет: они есть у представления, которое рисует строки. Они только раскрывают — штатное дерево из тулбара ничего не сворачивает. Внутри пакета expandCurrent() и expandTree() входят в него, как expandAll(), а export() отклоняется.

Управляющие элементы фильтров дерева — так же часть дерева, с данными и членами управляющих элементов фильтров группы, над условиями всех его групп.

Тулбар и фильтры платформы над строками представления​

Там, где строки группы рисует представление, платформа всё равно рисует то, что дизайн оставляет ей из тулбара и фильтров группы, — TOOLBARSYSTEM(o) и то, что содержат FILTERS(o) и FILTERCONTROLS(o), — если они вне контейнеров представления или размещены обратно с custom = NULL:

DESIGN items {
NEW cards {
custom = 'ItemCards';
MOVE GRID(i); // строки рисует представление; тулбар и фильтры остаются в BOX(i)
}
}

Над строками представления они работают так же, как над штатным гридом, с тем, что эти строки могут им сказать:

  • в тулбаре — кнопки, которым не нужна таблица: кнопка фильтров, количество строк, экспорт и ручное обновление, а переключения вида отображения, настроек и суммы колонки нет;
  • условия панели фильтров могут быть на колонках, которые несёт представление, с их подписями, а новое начинается на ячейке, на которой добавляется условие. Панель задаёт их списком группы — тем же, что задаёт действие FILTER, — и строки представления следуют за ним;
  • где условия рисует и само представление — оно получает filters группы, — панели платформа не строит: её управляющие элементы и кнопка фильтров в тулбаре дают команды над условиями представления;
  • клавиш штатного грида здесь нет, поэтому управляющие элементы открываются кнопкой фильтров в тулбаре — членом filterControlsVisible тулбара представления, где его рисует оно, — а где дизайн тулбар прячет, открыть их нечем: они скрыты с самого начала, как над штатным гридом, и так и остаются.

Дерево, которое рисует представление (MOVE GRID(TREE t)), получает то же самое — одно на все его группы, как у штатного дерева, — TOOLBARSYSTEM(TREE t) и то, что содержат FILTERS(TREE t) и FILTERCONTROLS(TREE t). В тулбаре — кнопки дерева: над строками представления кнопка, раскрывающая текущий объект, раскрывает то же, что expandCurrent() дерева, кнопка, раскрывающая дерево, — как над штатным деревом, все узлы группы текущего узла под раскрытыми узлами выше и узлы групп ниже, а пока текущего узла нет — ничего; всё дерево — это expandAll() верхней группы, — а экспорт выгружает дерево. Условия панели могут быть на колонках всех групп дерева, каждое — своей группы, а новое начинается на ячейке, на которой добавляется условие.

Того, что представление рисует само, платформа не строит: custom на BOX(o) рисует всю группу.