dash-b · Можливості · За натисканням

Панель, яка щось робить.

Більшість панелей за конструкцією призначені лише для читання: вони показують вам число і залишають вас іти кудись інакше, щоб на нього зреагувати. Плитка dash-b може нести кнопку, і натискання на неї додає рядок, оновлює його або відкриває форму, побудовану з вашої власної таблиці.

Дві плитки

Кнопка або форма

Дія

Одна кнопка з підписом, який ви обираєте. Вона виконує одну іменовану операцію над однією з ваших таблиць — позначити сьогоднішню виручку зданою до банку, додати зміну, закрити звернення. Нічого вводити, одне натискання.

Форма даних

Те саме, коли операція потребує деталей. Поля беруться з власної схеми таблиці, а не з того, що оголошує дизайн, тож перейменований вами стовпець змінює форму, а видалений стовпець перестає запитуватися.

Що таке дія

Три ключі, і жодного четвертого

Дія називає операцію, називає, над чим вона виконується, і передає параметри. Це весь словник:

  • Команда — це індекс у реєстрі, до якого може додавати лише власний код dash-b. Дизайн не може вигадати нову.
  • Прив'язка — це ім'я, яке під час натискання кнопки розв'язується щодо документів, які зберігає ваш обліковий запис. Дизайн, який вам надсилають і який називає таблицю, якої у вас немає, зупиняється і про це каже.
  • Параметри — це літерал або одне іменоване значення, прочитане з форми, плитки чи натискання. На один рівень углиб, і нічого більше.

URL, заголовок, токен або роль, записані в дію, — це мертва клавіша.

Ніщо в dash-b їх не читає. Тест надсилає дію, що несе всі чотири, і перевіряє, що жоден із них не дістався обробника.

Словник свідомо слабкий. Кожен оператор, доданий до мови параметрів, — це крок до рушія правил, що живе у файлі, який незнайомці надсилають одне одному, а файл дизайну — не місце, щоб виконувати чужу логіку.

Правила, яким підпорядковується запис

Три з них перевертають те, як поводиться решта dash-b

Невідома команда — це гучна помилка

Усюди інакше нерозпізнаний ключ тихо ігнорується, адже дизайн має пережити зустріч із новішою версією себе. Не тут: запис, який мовчки нічого не робить, виглядає точно так само, як той, що спрацював.

Зараховується лише справжнє натискання

Чи людина справді натиснула кнопку, вирішує середовище виконання, а не дизайн. Дизайн, який стверджує, що жест стався, відхиляється.

Усе, що змінює дані, вимагає підтвердження

Операції бувають лише для читання, локальні або змінювальні. Змінювальна спершу питає — і не може відмовитися питати — і отримує ключ, через який подвійне натискання спрацьовує один раз.

Де воно не з'являється

Не в експортованій HTML-сторінці

Експортуйте дизайн як окрему сторінку — і кнопок у ній не буде. Експорт не виконує жодного коду dash-b, тож форма там збирав би чиєсь введення, якому нікуди було б надіслатися — а це гірше, ніж взагалі її не пропонувати. Плитка — це можливість дизайнера й облікового запису, і експорт каже про це, просто не включаючи її.

Те саме стосується опублікованого посилання. Те, що читач може бачити, і те, чого не може, вирішується тим, чиї дані прив'язані до плитки — як працює спільний доступ викладає обидва випадки.

Йому потрібна таблиця, куди писати.

Це може бути таблиця у вашому обліковому записі або ваша власна база даних, до якої ви доходите через конектор, який хостите самі — і тоді жоден пароль бази даних ніколи не доходить до нас.