Saltar al contenido principal
La tela.html de una función se arma con piezas. Cada pieza tiene un nombre corto con @ (usado en la Skill y en componentes.md) y una etiqueta <dt-*> que tú escribes: Las piezas usan los mismos componentes del sitio de DoglyTdc: la caja de selección y el selector de color son los del resto del panel, en tema claro y oscuro.

bind: de dónde viene y adónde va el valor

Toda pieza que guarda o muestra un valor necesita bind="campo". El campo es el nombre del valor en la respuesta de la conexión y en lo que se guarda.
  • Nombre: empieza con letra; letras, números, _, . y -, hasta 64 caracteres.
  • Con connect.type: "config", el bind tiene que estar en connect.keys.
  • Con connect.type: "collection", solo dt-table y dt-stat.

@text y @textarea

@text acepta hasta 2.000 caracteres; @textarea, hasta 8.000.

@number

Un campo vacío se guarda como null.

@switch

Guarda true o false.

@select — caja de selección

<dt-select> es la caja; cada <dt-option> es una opción. <dt-option> solo funciona dentro de <dt-select> y necesita value y label.
  • El valor guardado siempre es texto, ej.: "rapido".
  • Valor por defecto: devuelve el campo en la carga ("modo": "natural") o déjalo ya guardado en la configuración.
  • Con más de 6 opciones, la caja gana búsqueda sola.
  • Etiquetas traducidas: label="@t.modo.rapido".

@color — selector de color

  • El valor se guarda como hexadecimal de 6 dígitos: "#8b5cf6".
  • Si el valor guardado no tiene ese formato (o no existe), el selector empieza en #8b5cf6.
  • Para otro valor por defecto, guarda el color antes en la configuración o devuélvelo en la carga.
En el script, usa el valor directamente:

@table

Con connect.type: "collection", la tabla muestra los registros de la colección. En los demás casos, muestra values.<bind> o, si no es una lista, rows.

@stat

Muestra un número o texto grande con icono.

@alert

icon opcional cambia el icono.

@button

Organización

Para ordenar la pantalla usa: section, div, header, footer, h2, h3, h4, p, span, strong, small y hr, con class opcional. Otras clases se ignoran.

Lo que está prohibido

  • JavaScript, <script>, <style>, style="" y on…="".
  • Enlaces, imágenes e iframes.
  • Elementos fuera de la lista y atributos que la pieza no tiene.
  • Más de 250 elementos, 12 niveles o 32 KB por pantalla.
Los errores indican el archivo y el motivo, ej.: Elemento não permitido: <img>, <dt-select> precisa de bind="campo"., bind="cor" não está em connect.keys.