dash-b · Funcionalidades · Ao clicar
Um painel que faz alguma coisa.
A maioria dos painéis é só de leitura por construção: mostram-te um número e deixam-te ir para outro lado para agir sobre ele. Um mosaico do dash-b pode ter um botão, e premê-lo escreve uma linha, atualiza uma ou abre um formulário construído a partir da tua própria tabela.
Dois blocos
Um botão, ou um formulário
Ação
Um botão com um rótulo que escolhes. Executa uma única operação com nome numa das tuas tabelas — marcar as receitas de hoje como depositadas, adicionar um turno, fechar um bilhete. Nada para escrever, um toque.
Formulário de dados
O mesmo quando a operação precisa de detalhes. Os campos são retirados do próprio esquema da tabela e não de nada que o design declare, por isso uma coluna que renomes muda o formulário e uma coluna que apagas deixa de ser pedida.
O que é uma ação
Três teclas, e nenhuma quarta
Uma ação nomeia uma operação, nomeia sobre o que opera e passa parâmetros. Este é todo o vocabulário:
- O comando é um índice num registo ao qual só o código do próprio dash-b pode acrescentar. Um design não pode inventar um.
- A ligação é um nome, resolvido quando o botão é premido contra os documentos que a tua conta tem. Um design que alguém te envie e que nomeie uma tabela que não tens para e diz-o.
- Os parâmetros são um literal, ou um valor com nome lido do formulário, do mosaico ou do toque. Um nível de profundidade, e nada mais.
Um URL, um cabeçalho, um token ou um papel escritos numa ação são uma tecla morta.
Nada no dash-b os lê. Um teste despacha uma ação que transporta os quatro e verifica que nenhum chegou ao handler.
O vocabulário é deliberadamente fraco. Cada operador que se acrescenta a uma linguagem de parâmetros é um passo em direção a um motor de regras a viver dentro de um ficheiro que desconhecidos enviam uns aos outros, e um ficheiro de design não é um sítio para executar a lógica de outra pessoa.
As regras que uma escrita obedece
Três destas são inversões do comportamento do resto do dash-b
Um comando desconhecido é um erro ruidoso
Em todo o resto, uma chave não reconhecida é ignorada em silêncio, porque um design deve sobreviver ao encontro com uma versão mais recente de si próprio. Aqui não: uma escrita que silenciosamente não faz nada parece-se exatamente com uma que funcionou.
Só uma pressão real conta
Se uma pessoa premiu realmente o botão é decidido pelo runtime, nunca pelo design. Um design que afirme que um gesto aconteceu é recusado.
Tudo o que altera dados confirma
As operações são só de leitura, locais ou de alteração. Uma de alteração pergunta primeiro — e não pode dispensar a pergunta — e recebe uma chave que faz um toque duplo contar apenas uma vez.
Onde não aparece
Não numa página HTML exportada
Exporta um design como página autónoma e os botões não vão nela. Uma exportação não executa nenhum código do dash-b, por isso um formulário aí recolheria a escrita de alguém e não teria para onde enviá-la — o que é pior do que não a oferecer de todo. O mosaico é uma funcionalidade de designer e de conta, e a exportação diz-no ao deixá-lo de fora.
O mesmo vale para uma ligação publicada. O que um leitor pode ver, e o que não pode, é decidido por a que dados o mosaico está ligado — como funciona a partilha expõe ambos os casos.
Precisa de uma tabela para escrever.
Pode ser uma tabela na tua conta, ou a tua própria base de dados alcançada através de um conector que tu alojas — caso em que nenhuma palavra-passe de base de dados chega alguma vez até nós.