dash-b · Funksjonar · Ved klikk

Eit dashbord som gjer noko.

Dei fleste dashbord er skrivebeskytta av konstruksjon: dei viser deg eit tal og lar deg gå andre stader for å gjera noko med det. Ei dash-b-flis kan ha ein knapp, og å trykkja på han skriv ei rad, oppdaterer ei, eller opnar eit skjema bygd frå di eiga tabell.

To fliser

Ein knapp, eller eit skjema

Handling

Ein knapp med ein etikett du vel sjølv. Han køyrer éi namngjeven operasjon mot ei av dine eigne tabellar — merk dagens inntekt som banka inn, legg til eit skift, lukk ein sak. Ingenting å skriva, eitt trykk.

Datakjema

Det same når operasjonen treng detaljar. Felta er henta frå tabellen si eiga struktur i staden for frå noko designet seier, så ei kolonne du endrar namn på endrar skjemaet, og ei kolonne du slettar sluttar å bli spurt om.

Kva ei handling er

Tre nøklar, og ingen fjerde

Ein handling namngjev ein operasjon, namngjev kva han verkar på, og sender med parametrar. Det er heile ordforrådet:

  • Kommandoen er ein indeks inn i eit register som berre dash-b sin eigen kode kan leggja til. Eit design kan ikkje finna på éin.
  • Bindinga er eit namn, løyst når knappen blir trykt mot dokumenta din konto har. Eit design nokon sender deg som nemner ein tabell du ikkje har, stoppar og seier det.
  • Parametrane er ein konstant, eller éi namngjeve verdi lesen frå skjemaet, flisa eller trykket. Eitt nivå djupt, og ingenting anna.

Ein URL, ein header, ein token eller ei rolle skriven inn i ei handling er ein død nøkkel.

Ingenting i dash-b les dei. Ein test sender ei handling som ber med alle fire, og kontrollerer at ingen av dei nådde handsamaren.

Ordforrådet er med vilje svakt. Kvar operatør som blir lagt til i eit parameterspråk er eit steg mot ein regelmotor som lever inni ei fil framande sender kvarandre, og ei designfil er ikkje ein stad å køyra logikken til nokon andre.

Reglane ei skriving følgjer

Tre av desse snur på korleis resten av dash-b oppfører seg

Ein ukjend kommando er ein høg feil

Alle andre stader blir ein ukjend nøkkel ignorert i stillheit, fordi eit design bør overleva å møta ein nyare versjon av seg sjølv. Ikke her: ein skriving som i stillheit ikkje gjer noko ser nøyaktig lik ut som éin som verka.

Berre eit ekte trykk tel

Om ein person faktisk trykte knappen blir avgjort av kjøretidsmiljøet, aldri av designet. Eit design som hevdar at ei handling skjedde, blir avvist.

Alt som endrar data stadfestar

Operasjonar er skrivebeskytta, lokale, eller endrande. Ein endrande spør først — og kan ikkje frita seg frå å spørja — og får ein nøkkel som gjer at eit dobbelttrykk landar éin gong.

Der det ikkje visast

Ikkje på ei eksportert HTML-side

Eksporterer du eit design som ei sjølvstendig side, er knappane ikkje med. Ein eksport køyrer ingen av dash-b sin kode, så eit skjema der ville samla inn skrivinga til nokon og ikkje hatt nokon stad å senda henne — noko som er verre enn å ikkje tilby ho i det heile. Flisa er ein designar- og kontofunksjon, og eksporten seier det ved å la henne vera ute.

Det same gjeld ei publisert lenkje. Kva ein lesar kan sjå, og kva dei ikkje kan, blir avgjort av kven sin data flisa er bunden til — korleis deling fungerer set opp begge tilfella.

Det treng ei tabell å skriva til.

Det kan vera ein tabell på kontoen din, eller di eiga database nådd gjennom ein kopling du hostar — i så fall når ingen databasepassord nokonsinne fram til oss.