dash-b · Funkce · Po kliknutí

Přehled, který něco dělá.

Většina přehledů je z principu jen pro čtení: zobrazí číslo a nechá vás jít jinam, abyste mohli jednat. Dlaždice dash-b může nést tlačítko a jeho stisknutí zapíše řádek, aktualizuje ho nebo otevře formulář vytvořený z vaší vlastní tabulky.

Dvě dlaždice

Tlačítko, nebo formulář

Akce

Jedno tlačítko s popiskem, který si zvolíte. Spustí jednu pojmenovanou operaci nad jednou z vašich tabulek — označit dnešní tržbu jako odvedenou, přidat směnu, uzavřít lístek. Nic se nepíše, jeden stisk.

Datový formulář

Totéž, když operace potřebuje podrobnosti. Pole se čerpají z vlastního schématu tabulky, nikoli z čehokoli, co návrh deklaruje, takže sloupec, který přejmenujete, změní formulář a sloupec, který smažete, se přestane vyžadovat.

Co je akce

Tři klíče a žádný čtvrtý

Akce pojmenovává operaci, pojmenovává, na co působí, a předává parametry. To je celá slovní zásoba:

  • Příkaz je index do registru, do kterého může přidávat pouze vlastní kód dash-b. Návrh si žádný nemůže vymyslet.
  • Vazba je název, který se při stisknutí tlačítka vyřeší proti dokumentům, které drží váš účet. Návrh, který vám někdo pošle a který pojmenovává tabulku, kterou nemáte, se zastaví a řekne to.
  • Parametry jsou literál, nebo jedna pojmenovaná hodnota přečtená z formuláře, dlaždice nebo stisku. Jedna úroveň do hloubky a nic víc.

URL adresa, hlavička, token nebo role zapsané do akce jsou mrtvý klíč.

Nic v dash-b je nečte. Test odešle akci nesoucí všechny čtyři a ověří, že se k obsluze nedostal žádný z nich.

Slovní zásoba je záměrně slabá. Každý operátor, který se přidá do jazyka parametrů, je krok k pravidlovému stroji žijícímu uvnitř souboru, který si cizí lidé posílají navzájem — a soubor s návrhem není místo, kde by běžela cizí logika.

Pravidla, kterým zápis podléhá

Tři z nich jsou obrácením chování, jaké má zbytek dash-b

Neznámý příkaz je hlasitá chyba

Všude jinde se nerozpoznaný klíč tiše ignoruje, protože návrh by měl přežít setkání s novější verzí sebe sama. Ne tady: zápis, který potichu nic neudělá, vypadá úplně stejně jako ten, který se povedl.

Počítá jen skutečné stisknutí

O tom, zda člověk tlačítko skutečně stiskl, rozhoduje běhové prostředí, nikdy ne návrh. Návrh, který tvrdí, že gesto proběhlo, je odmítnut.

Cokoli, co mění data, vyžaduje potvrzení

Operace jsou buď jen pro čtení, místní, nebo měnící. Měnící se se nejprve zeptá — a nemůže se ptát vyhnout — a dostane klíč, díky kterému dvojitý stisk proběhne jen jednou.

Kde se nezobrazuje

Ne v exportované stránce HTML

Exportujete-li návrh jako samostatnou stránku, tlačítka v něm nejsou. Export nespouští žádný kód dash-b, takže formulář by tam sbíral něčí psaní a neměl kam ho poslat — což je horší, než když se nenabízí vůbec. Dlaždice je funkcí návrháře a účtu a export to říká tím, že ji vynechá.

Totéž platí pro publikovaný odkaz. To, co si čtenář může zobrazit a co ne, rozhoduje to, na čí data je dlaždice vázána — jak funguje sdílení popisuje oba případy.

Potřebuje tabulku, do které zapisuje.

Může to být tabulka na vašem účtu, nebo vaše vlastní databáze dosažená přes konektor, který hostujete vy — v takovém případě se k nám nikdy nedostane žádné heslo k databázi.