Pular para o conteúdo principal
A tela.html de uma função é montada com peças. Cada peça tem um nome curto com @ (usado na Skill e no componentes.md) e uma marca <dt-*> que você escreve: As peças usam os mesmos componentes do site do DoglyTdc: a caixa de seleção e o seletor de cor são os do resto do painel, no tema claro e escuro.

bind: de onde vem e para onde vai o valor

Toda peça que guarda ou mostra um valor precisa de bind="campo". O campo é o nome do valor na resposta da ligação e no que é salvo.
  • Nome: começa com letra; letras, números, _, . e -, até 64 caracteres.
  • Com connect.type: "config", o bind precisa estar em connect.keys.
  • Com connect.type: "collection", só dt-table e dt-stat.

@text e @textarea

@text aceita até 2.000 caracteres; @textarea, até 8.000.

@number

Campo vazio é salvo como null.

@switch

Salva true ou false.

@select — caixa de seleção

<dt-select> é a caixa; cada <dt-option> é uma opção. <dt-option> só funciona dentro de <dt-select> e precisa de value e label.
  • O valor salvo é sempre texto, ex.: "rapido".
  • Valor padrão: devolva o campo na carga ("modo": "natural") ou deixe-o já salvo na configuração.
  • Com mais de 6 opções, a caixa ganha busca sozinha.
  • Rótulos traduzidos: label="@t.modo.rapido".

@color — seletor de cor

  • O valor é salvo como hexadecimal de 6 dígitos: "#8b5cf6".
  • Se o valor salvo não for nesse formato (ou não existir), o seletor começa em #8b5cf6.
  • Para outro padrão, salve a cor antes na configuração ou devolva-a na carga.
No script, use o valor direto:

@table

Com connect.type: "collection", a tabela mostra os registros da coleção. Nos outros casos, mostra values.<bind> ou, se não for lista, rows.

@stat

Mostra um número ou texto grande com ícone.

@alert

icon opcional troca o ícone.

@button

Organização

Para arrumar a tela use: section, div, header, footer, h2, h3, h4, p, span, strong, small e hr, com class opcional. Outras classes são ignoradas.

O que é proibido

  • JavaScript, <script>, <style>, style="" e on…="".
  • Links, imagens e iframes.
  • Elementos fora da lista e atributos que a peça não tem.
  • Mais de 250 elementos, 12 níveis ou 32 KB por tela.
Os erros dizem o arquivo e o motivo, ex.: Elemento não permitido: <img>, <dt-select> precisa de bind="campo"., bind="cor" não está em connect.keys.