dash-b · Возможности · По нажатию
Панель, которая действует.
Большинство панелей по своей конструкции доступны только для чтения: они показывают вам число и оставляют вас идти куда-то ещё, чтобы на него отреагировать. Плитка dash-b может нести кнопку, и её нажатие записывает строку, обновляет её или открывает форму, построенную по вашей собственной таблице.
Две плитки
Кнопка или форма
Действие
Одна кнопка с подписью, которую вы выбираете. Она выполняет одну именованную операцию над одной из ваших таблиц — отметить сегодняшнюю выручку сданной в банк, добавить смену, закрыть заявку. Ничего вводить не нужно, одно нажатие.
Форма данных
То же самое, когда операции нужны подробности. Поля берутся из собственной схемы таблицы, а не из того, что объявляет дизайн, поэтому переименованный вами столбец меняет форму, а удалённый столбец перестаёт запрашиваться.
Что такое действие
Три клавиши, и никакой четвёртой
Действие называет операцию, называет то, над чем она выполняется, и передаёт параметры. Вот и весь словарь:
- Команда — это индекс в реестре, который может пополнять только собственный код dash-b. Дизайн не может придумать новую.
- Привязка — это имя, разрешаемое в момент нажатия кнопки по документам, которые хранит ваша учётная запись. Присланный вам дизайн, называющий таблицу, которой у вас нет, останавливается и сообщает об этом.
- Параметры — это литерал или одно именованное значение, прочитанное из формы, плитки или нажатия. Один уровень вглубь, и больше ничего.
URL, заголовок, токен или роль, вписанные в действие, — это мёртвый ключ.
Ничто в dash-b их не читает. Тест отправляет действие со всеми четырьмя и проверяет, что ни один из них не дошёл до обработчика.
Словарь намеренно слаб. Каждый оператор, добавляемый в язык параметров, — это шаг к движку правил, живущему внутри файла, которым незнакомцы обмениваются друг с другом, а файл дизайна — не место для чужой логики.
Правила, которым подчиняется запись
Три из них переворачивают то, как ведёт себя остальной dash-b
Неизвестная команда — громкая ошибка
Везде остальном нераспознанный ключ тихо игнорируется, потому что дизайн должен пережить встречу с более новой версией самого себя. Не здесь: запись, которая молча ничего не делает, выглядит в точности как сработавшая.
Засчитывается только настоящее нажатие
Была ли кнопка действительно нажата человеком, решает среда выполнения, а никогда — дизайн. Дизайн, утверждающий, что жест произошёл, отклоняется.
Любое изменение данных требует подтверждения
Операции бывают только для чтения, локальные или изменяющие. Изменяющая сначала спрашивает — и не может отказаться от вопроса — и получает ключ, благодаря которому двойное нажатие срабатывает один раз.
Где оно не появляется
Не на экспортированной HTML-странице
Экспортируйте дизайн как самостоятельную страницу — и кнопок в ней не будет. Экспорт не выполняет ни строчки кода dash-b, поэтому форма там собирала бы чей-то ввод, которому некуда было бы отправиться — что хуже, чем вообще её не предлагать. Плитка — возможность дизайнера и учётной записи, и экспорт сообщает об этом самим своим отсутствием.
То же самое касается опубликованной ссылки. Что читатель может видеть, а что нет, решается тем, к чьим данным привязана плитка — как работает обмен описывает оба случая.
Ей нужна таблица, в которую можно писать.
Это может быть таблица в вашей учётной записи или ваша собственная база данных, доступ к которой идёт через коннектор, размещённый у вас, — и в этом случае пароль базы данных никогда не доходит до нас.