dash-b · Funciones · Al hacer clic
Un panel que hace algo.
La mayoría de los paneles son de solo lectura por construcción: te muestran un número y te dejan ir a otro sitio para actuar. Una tarjeta de dash-b puede llevar un botón, y al pulsarlo se escribe una fila, se actualiza una o se abre un formulario creado a partir de tu propia tabla.
Dos mosaicos
Un botón, o un formulario
Acción
Un botón con la etiqueta que tú elijas. Ejecuta una única operación con nombre sobre una de tus propias tablas: marcar las recaudaciones de hoy como ingresadas, añadir un turno, cerrar un ticket. Nada que escribir, una pulsación.
Formulario de datos
Lo mismo cuando la operación necesita detalles. Los campos se toman del esquema de la propia tabla y no de nada que declare el diseño, así que una columna que renombras cambia el formulario y una columna que eliminas deja de pedirse.
Qué es una acción
Tres claves, y sin cuarta
Una acción nombra una operación, nombra sobre qué opera y pasa parámetros. Ese es todo el vocabulario:
- El comando es un índice en un registro al que solo puede añadir el propio código de dash-b. Un diseño no puede inventar uno.
- La vinculación es un nombre que se resuelve, al pulsar el botón, contra los documentos que contiene tu cuenta. Un diseño que alguien te envía y que nombra una tabla que no tienes se detiene y te lo dice.
- Los parámetros son un literal, o un valor con nombre leído del formulario, de la tarjeta o de la pulsación. Un nivel de profundidad, y nada más.
Una URL, una cabecera, un token o un rol escritos dentro de una acción son una tecla muerta.
Nada en dash-b los lee. Una prueba despacha una acción que lleva los cuatro y comprueba que ninguno llegó al manejador.
El vocabulario es deliberadamente limitado. Cada operador que se añade a un lenguaje de parámetros es un paso hacia un motor de reglas viviendo dentro de un archivo que desconocidos se envían entre sí, y un archivo de diseño no es un lugar para ejecutar la lógica de otra persona.
Las reglas que obedece una escritura
Tres de estas cosas invierten cómo se comporta el resto de dash-b
Un comando desconocido es un error ruidoso
En todos los demás lugares, una clave no reconocida se ignora en silencio, porque un diseño debería sobrevivir al encuentro con una versión más nueva de sí mismo. Aquí no: una escritura que no hace nada en silencio se ve exactamente igual que una que funcionó.
Solo cuenta una pulsación real
Si una persona pulsó realmente el botón lo decide el runtime, nunca el diseño. Un diseño que afirma que ocurrió un gesto es rechazado.
Todo lo que cambia datos pide confirmación
Las operaciones son de solo lectura, locales o de modificación. Una de modificación pregunta primero —y no puede eximirse de preguntar— y recibe una clave que hace que una doble pulsación cuente solo una vez.
Dónde no aparece
No en una página HTML exportada
Exporta un diseño como página independiente y los botones no van dentro. Una exportación no ejecuta nada del código de dash-b, así que un formulario allí recogería lo que alguien escribe y no tendría a dónde enviarlo, lo cual es peor que no ofrecerlo en absoluto. La tarjeta es una función del diseñador y de la cuenta, y la exportación lo dice omitiéndola.
Lo mismo vale para un enlace publicado. Lo que un lector puede ver, y lo que no, lo decide a qué datos está vinculada la tarjeta: cómo funciona compartir expone ambos casos.
Necesita una tabla donde escribir.
Puede ser una tabla de tu cuenta, o tu propia base de datos alcanzada a través de un conector que tú alojas, en cuyo caso ninguna contraseña de base de datos nos llega jamás.