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

Деревья, сортировки и выделение в React

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

Деревья​

Группа дерева проецируется как любая другая: контейнер имеет от неё ровно то, что положили туда её собственные компоненты, — а там, где рисуются строки ДЕРЕВА, это list, byKey, keys и сами строки. И каждая такая строка говорит, где она стоит в иерархии:

{
key, current, objects, ...ячейки,
parent, // ключ строки, под которой она висит
hasChildren, // есть ли у неё дети, загружены они или нет
expanded, // раскрыта ли она
loading, // true, пока загружаются его дети
}

Каждое поле, которое добавляет строка дерева, зарезервировано там, где рисуются строки дерева, как и key: свойство, нарисованное на такой строке, не может взять это имя.

parent — ключ той строки, под которой висит эта, и null на верхнем уровне дерева; он указывает в ту группу, которой родитель принадлежит (строки дерева ключуются всем путём до них, поэтому ключи его групп не сталкиваются — кроме объекта строкового класса, в значении которого есть |). Записан он так же, как записывается key, поэтому row.parent === parentRow.key действительно выполняется, а не просто похоже выглядит. Строки приходят под загруженным родителем, поэтому названный родитель обычно на месте — пока что-нибудь его не унесёт: фильтр по верхней группе убирает строку-родителя, а её дети остаются (сервер продолжает их присылать), и с этого момента parent может называть строку, которой у клиента нет. Поэтому вид, индексирующий строки по ключу, должен решить, что делать со строкой, чьего родителя он не нашёл, а не считать, что поиск удался. Предков строки вид находит так же: идёт по parent через byKey той группы, которой принадлежит родитель, и останавливается на родителе, которого у него нет. Глубине, на которую строка сдвинута, такой обход не нужен: она получается сама, когда дерево рисуется от корней вниз.

hasChildren — то, что сервер говорит о наличии детей, загружены они или нет; это не атрибут дизайна, а живое состояние дерева.

expanded — что узел раскрыт: его дети загружены — или вид попросил раскрыть или свернуть его, а строки ответа ещё не пришли, и тогда он говорит то, о чём попросили: так же изменённое значение показывается до ответа, и так же штатное дерево меняет значок раскрытия по щелчку. Узел сворачивается сразу, а его дети остаются в list, пока их не уберёт ответ, поэтому вид, который рисует детей узла только под expanded-узлом, сразу их и прячет. Раскрывается только узел с детьми: узел, у которого hasChildren ложно, остаётся свёрнутым, как и в штатном дереве. Это тоже живое состояние.

Если запрос на раскрытие или сворачивание завершился ошибкой без обновления строк, expanded сохраняет запрошенное состояние, пока сервер не пришлёт строки группы узла или непосредственно следующей за ней группы дерева в ответ на этот или более поздний запрос.

loading равно true, пока загружаются дети узла: вид попросил раскрыть его, а строки ответа ещё не пришли, — так же, как loading ячейки говорит, что её изменение ждёт ответа. Сворачивание узла ничего не загружает, как и раскрытие узла, у которого hasChildren ложно; поле есть, только пока оно true.

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

Строка нижней группы несёт путь над собой, поэтому строка, ставшая текущей — через change(row) или по сообщению сервера, — делает текущими в их группах и строки на этом пути. current следует по пути вверх, как дерево платформы выделяет один узел. Группы под ней остаются без текущей строки — сервер сбрасывает их текущие объекты, когда выбрана строка выше. У каждой строки этих групп current равно false, пока там снова не выберут строку.

controller.<g>.expand(row) / .collapse(row) / .toggle(row) открывают и закрывают один узел: узел — это строка группы, поэтому они групповые. Каждый принимает строку (саму строку, её objects или её ключ) и возвращает Promise своего запроса: expanded строки меняется сразу, а её дети приходят строками. toggle просит противоположное тому, что сейчас говорит expanded строки, поэтому два переключения до ответа раскрывают узел и снова сворачивают. controller.<g>.expandAll() раскрывает все узлы группы и групп под ней: у верхней группы дерева — всё дерево, у группы ниже — её узлы под раскрытыми узлами выше. controller.<g>.collapseAll() сворачивает те же узлы и все узлы под ними, поэтому узел, раскрытый после этого снова, показывает своих детей свёрнутыми. expanded их строк тоже меняется сразу. У группы вне дерева таких членов просто нет: все пять ставятся только на группу дерева и зарезервированы в узле такой группы, как и list.

Эти глаголы — члены узла группы, поэтому контейнер имеет их ровно там, где имеет её строки: у дерева, которое рисует React. Дерево, которое рисует платформа, раскрывается её собственным значком, и ни у одного React-контейнера нет для него глаголов узла; представление, которое рисует его тулбар, раскрывает его двумя кнопками тулбара.

FORM catalogue
TREE t c = Category PARENT parent(c), i = Item
PROPERTIES(c) name
PROPERTIES(i) name
FILTERS category(i) == c
;

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

Где представление рисует строки дерева, узел дерева говорит, какая из них текущая, и несёт единственный глагол, которому это нужно знать, — ни одна группа не знает этого сама:

в узлечленчто это
currentключ текущей строки дерева — текущей строки той группы, чей текущий объект задан последним, представлением или сервером, как выделенная строка у штатного дерева, — null, пока её нет
expandCurrent()раскрывает текущий узел и все узлы под ним

current записан так же, как key, поэтому row.key === data.t.current выполняется, как и row.parent === parentRow.key. Он null, пока у дерева нет загруженной текущей строки: пока строку не выбрали, пока группа текущего узла не стоит ни на одной строке, пока её строка не пришла или уже ушла — и никогда не подменяется строкой выше. Текущей строку делает change(row) её группы; current только говорит, какая, и своего члена у него нет. controller.<tree>.expandCurrent() читает текущий узел в момент вызова и ничего не делает, пока его нет или у него нет детей; узлы, которые он раскрывает, сразу expanded, а loading — пока не придут их строки. Внутри пакета он входит в пакет, поэтому раскрывает строку, которую раньше в том же пакете сделал текущей change(row).

Сортировки​

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

Представление, которое рисует строки группы вне дерева, несёт orders — сортировки группы в порядке приоритета — рядом с list и keys: сортировка это порядок, в котором рисуются строки, поэтому она проецируется туда, где они рисуются, а у контейнера, где лежит только панельное свойство группы, нет ни того, ни другого. Там, где поле есть, оно есть всегда и пусто, когда группа ничем не отсортирована. Каждая запись — объект:

ПолеЗначение
propertyИнтеграционный SID свойства, по которому сортируется, — в узле дерева вместе с именем его группы, как ниже
descСортировать ли по убыванию

Та же форма записи, которую применяет оператор ORDER ... FROM и читает ORDERS ... TO, с одной разницей: orders называет свойство так же, как остальной узел, — интеграционным SID, — а эти операторы называют его SID свойства на форме (sum(o)).

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

controller.<group>.orders.change(...) — член ровно там же и только там. Он меняет одну сортировку, не трогая остальные и их приоритет: уже отсортированное свойство сохраняет своё место при смене направления, новое добавляется в конец. Запись без desc — не сортировка, поэтому она отменяет сортировку по этому свойству. Массив — controller.<group>.orders.change(orders) — заявляет список целиком, поэтому то, что в него не попало, перестаёт сортировать группу.

Изменение через контроллер отправляется сразу, всем списком группы, — тем же запросом, что клик по штатному заголовку, — и orders показывает его тут же, ещё до того, как придут строки в новом порядке; ответ на запрос, сделанный раньше, его не отменяет.

Сортировки дерева — его собственные, как и его пользовательские фильтры: там, где представление рисует строки дерева, data.<tree>.orders перечисляет сортировки всех его групп, группа за группой, сверху вниз, — у каждой группы в её собственном порядке приоритета: сортировки одной группы не старше сортировок другой, — каждое свойство названо именем своей группы и своим, c.name; в узлах его групп orders нет. controller.<tree>.orders.change(...) меняет их так же: одна запись вливается в сортировки своей группы, а массив заявляет весь список дерева — каждая группа получает записи на своих свойствах, а группа, ни одного свойства которой он не называет, перестаёт сортироваться. Список каждой группы отправляется так же, как список группы.

orders описывает ту сортировку, которую пользователь может менять, кто бы её ни заявил. Фиксированная сортировка в неё не входит и войти не может: ORDERS ... FIXED, а также запись ORDERS, которая является выражением, а не свойством, нарисованным на форме, применяются на сервере и на клиент не передаются вовсе. Не входит и неявная сортировка по объектам самой группы, которая делает чтение устойчивым. Поэтому строки могут быть упорядочены сильнее, чем говорит orders, и вид не может показать индикатор для той части, о которой ему не сообщили.

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

Ещё два вида сортировок не перечисляются, и при появлении любой из них об этом говорит сообщение в консоли: сортировка по свойству без интеграционного SID (NOEXTID), для которого у проекции нет имени, и сортировка по свойству, сгруппированному в колонки: сортировка здесь называет свойство, а не одну из его колонок.

Поскольку форма-массив заявляет список целиком, вернуть в неё data.<group>.orders — значит снять эти две сортировки — по свойству с NOEXTID и по свойству, сгруппированному в колонки; изменение ОДНОЙ сортировки не трогает того, чего не называет.

Каждое свойство само говорит, стоит ли виду предлагать сортировку по нему: data.<group>.<property>.noSort равно true у свойства, у которого так сказано в дизайне:

DESIGN orders {
PROPERTY(number(o)) { noSort = TRUE; }
}

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

noSort запрещает сортировку, которую заявляет ПОЛЬЗОВАТЕЛЬ, но не ту, которую заявляет форма. Заявленное формой может назвать такое свойство — и запись ORDERS на нём, и действие ORDER, называющее его: сервер по ней сортирует, и orders об этом говорит — как и заголовок штатного грида: не предлагается только клик, который сортировал бы по такому свойству.

Просьба отсортировать ПО свойству, объявленному с noSort, отвергается, как и список, называющий одно свойство дважды, имя, которого у группы нет, и свойство, сгруппированное в колонки. Снять noSort-сортировку — значит заявить запись без desc, и это разрешено: запрещено сортировать по такому свойству, а не переставать.

Выделенные строки и колонки​

Представление, которое рисует строки группы вне дерева, выделяет строки и колонки так же, как таблица платформы. Выделенные строки сервер хранит как диапазон в текущем порядке группы (выделение), поэтому в диапазон входят и строки, которые представление не прочитало. У строки из диапазона в list есть selected; change на строку меняет диапазон у строк list сразу, до ответа сервера, — кроме 'extend' от текущей строки, которой в list нет: его приносит ответ. Колонки — это списочные свойства, которые представление рисует в своих строках, кроме действий, в порядке properties. В записи колонки — той, где её заголовок, — есть current, текущая ли это колонка, и selected, входит ли она в диапазон выделенных колонок. Ячейка выделена там, где выделены и её строка, и её колонка.

Члены, которые меняют выделение, находятся в члене группы там, где рисуются её строки, и только там:

ЧленЧто делает
change(row[, {selection}])Делает строку текущей и меняет выделенные строки
change({to: 'home'}[, {selection}]), change({to: 'end'}[, {selection}])Выполняет переход к первой или последней строке и меняет выделенные строки. Эти два края списка есть у контроллера формы — form.HOME и form.END
properties.change(column[, {selection}])Делает текущей колонку, названную именем её свойства, и меняет выделенные колонки
selectAll()Выделяет все строки, прошедшие фильтры, и все колонки. Текущая строка и текущая колонка остаются прежними

Каждый возвращает Promise своего запроса. Что вызов делает с выделением, говорит selection:

selectionСтрокиКолонки
'start' или не заданоНи одна строка не выделена, диапазон начинается с этой строкиВыделена только эта колонка, диапазон начинается с неё
'extend'Выделены строки от той, с которой начинается диапазон, до этойВыделены колонки от той, с которой начинается диапазон, до этой
'keep'Выделенные строки остаются прежними. Пока ни одна строка не выделена, диапазон начинается с этой строкиВыделенные колонки остаются прежними

Два диапазона независимы: смена строки не трогает выделенные колонки, а смена колонки — выделенные строки. Таблица платформы меняет оба одним перемещением ячейки; представление делает это двумя вызовами, которые пакет отправляет одним запросом, — например, по щелчку на ячейке:

function Cell({ row, name, controller }) {
const select = selection => controller.batch(() => {
controller.i.change(row, { selection });
controller.i.properties.change(name, { selection });
});
return <td onClick={e => select(e.shiftKey ? 'extend' : 'start')}>{row[name].value}</td>;
}

Клавиши таблицы платформы представление обрабатывает само, как и остальные клавиши таблицы:

function onKeyDown(e, controller) {
const selection = e.shiftKey ? 'extend' : 'start';
if (e.ctrlKey && e.key === 'Home')
controller.i.change(controller.form.HOME, { selection });
else if (e.ctrlKey && e.key === 'End')
controller.i.change(controller.form.END, { selection });
else if (e.ctrlKey && e.key === 'a')
controller.i.selectAll();
}

Первую или последнюю строку сервер находит, когда читает строки группы, после всех изменений запроса — как и для ACTIVATE FIRST / LAST в действии. Поэтому вызов, сделанный после такого перехода в том же пакете, по-прежнему работает со строкой, которая была текущей до него.

Форма видит это выделение так же, как выделение в таблице платформы: его возвращают свойства SELECT, SELECT ACTIVE и SELECT PROPERTY, текущая колонка — активное свойство (ACTIVE PROPERTY), и происходят события SELECT и SELECT PROPERTY формы.

Колонку, которую форма сейчас не показывает — её запись hidden, — сделать текущей нельзя, а имя, которое не называет колонку, отклоняется. У группы дерева выделения нет: её change принимает только строку, а из значений selection — только 'keep'. useSeekOnScroll меняет текущую строку с 'keep': прокрутка, как и в таблице платформы, выделение не трогает.

Выделение принадлежит представлению, которое рисует строки. Другой контейнер меняет его через контроллер формы — controller.form.changeObject('<group>', row, {selection}), changeColumn('<group>', column, {selection}) и selectAll('<group>') (между контейнерами). Там, где строки рисует таблица платформы, те же вызовы меняют собственное выделение таблицы: колонка становится текущей, если таблица сейчас её показывает и пользователь может на неё перейти, а у свойства, сгруппированного в колонки, колонки с таким именем нет. Пока таблица показывает строки другим представлением — сводной таблицей, картой, календарём, пользовательским представлением, — вызовы отклоняются, как и для группы дерева: changeObject принимает там строку, а из значений selection — только 'keep'.

Буфер обмена​

Представление, которое рисует строки группы вне дерева, копирует и вставляет выделенные ячейки ещё двумя членами там же:

ЧленЧто делает
copy()Возвращает Promise текста выделенных ячеек
paste(text)Вставляет текст в выделенные ячейки и возвращает Promise своего запроса

copy форматирует значения так же, как таблица платформы: по типу значения и формату свойства. Для текущей строки, копируемой без запроса к серверу, собственный формат ячейки имеет приоритет, если он задан. Выделенные строки, прочитанные с сервера, используют формат свойства. paste принимает этот текст с табуляцией и переносами строк, в том числе скопированный из таблицы платформы или электронной таблицы.

Пока ни у одной строки list нет selected, строка — текущая, а пока ни одна колонка не выделена, колонка — текущая. copy возвращает текст текущей строки без запроса к серверу. Без текущей строки в list ничего не вставляется, а без колонки copy возвращает пустой текст. paste('') ничего не делает.

copy и paste — отдельные вызовы. Пакет их не несёт, и внутри пакета они отклоняются. paste не спрашивает, поэтому представление, которому нужен этот вопрос, задаёт его само.

События copy и paste браузера представление обрабатывает само и отдаёт текст в буфер обмена, когда получает его:

<div tabIndex={0}
onCopy={e => {
e.preventDefault();
controller.i.copy().then(text => navigator.clipboard.writeText(text));
}}
onPaste={e => {
e.preventDefault();
controller.i.paste(e.clipboardData.getData('text/plain'));
}}>
...
</div>

Другой контейнер копирует и вставляет через контроллер формы — controller.form.copy('<group>') и paste('<group>', text). Они отклоняются там же, где вызовы выделения. В этих вызовах над таблицей платформы колонка действия и колонка свойства, сгруппированного в колонки, в число ячеек не входят, и несколько значений не вставляются, пока такая колонка текущая.