fluig-scaffolding-form
Gera o esqueleto de um Form (formulário eletrônico) do Fluig — definição de campos, view/markup, eventos e (quando solicitado) tabela Pai x Filho com tablename, template de linha e orientações de consumo via dataset, aplicando as convenções oficiais. Use quando o desenvolvedor pedir para criar/iniciar um novo formulário do Fluig a partir de um nome ou propósito e seus campos.
totvs · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add totvs/fluig-agent-skills --skill fluig-scaffolding-form技能说明
name: fluig-scaffolding-form description: Gera o esqueleto de um Form (formulário eletrônico) do Fluig — definição de campos, view/markup, eventos e (quando solicitado) tabela Pai x Filho com tablename, template de linha e orientações de consumo via dataset, aplicando as convenções oficiais. Use quando o desenvolvedor pedir para criar/iniciar um novo formulário do Fluig a partir de um nome ou propósito e seus campos. argument-hint: 'nome e/ou propósito do formulário, campos e regras de validação (ex.: "formulário de solicitação de férias com nome, data de início e dias")'
Scaffolding de Form (Formulário eletrônico)
Esta skill gera o esqueleto de um Form do Fluig; ela não duplica convenções — os arquivos de context/ são a fonte de verdade, referenciada abaixo.
Objetivo
Produzir, com responsabilidade única, o esqueleto de um Form (formulário eletrônico) do Fluig: a definição dos campos, a view/markup do formulário e o arquivo de eventos com os handlers de ciclo de vida e de campos que implementam validação e regras de preenchimento, já em conformidade com as convenções públicas.
Quando a entrada pedir grade dinâmica, o escopo inclui também a estrutura de
tabela Pai x Filho (HTML com tablename, linha-base no <tbody> e acionamento
de inclusão/remoção de filhos), seguindo as regras oficiais.
Quando Usar
- Ao criar um novo formulário eletrônico do Fluig a partir do zero.
- Quando o desenvolvedor fornece um nome/propósito e a lista de campos e quer um ponto de partida correto (campos + view + eventos) seguindo as convenções oficiais.
- Quando é preciso garantir, desde o início, i18n nos textos visíveis, validação/sanitização da entrada do usuário e código em ES6+.
- Quando o formulário precisa de coleções dinâmicas (itens, aprovações, anexos lógicos etc.) com modelagem em Pai x Filho.
Entradas Esperadas
| Entrada | Descrição | Obrigatória |
|---|---|---|
| Nome do formulário | Identificador camelCase do formulário — usado como nome do arquivo HTML e como prefixo dos arquivos .properties (ex.: registroIncidenteTI) | sim |
| Campos | Lista de campos do formulário (nome, tipo e se é obrigatório) | sim |
| Regras de validação | Regras de preenchimento/consistência por campo ou para o formulário | não |
Contexto de Referência (Fonte de Verdade)
Leia antes de executar — não reproduza o conteúdo aqui:
- architecture.md — modelo conceitual do Form e seus pontos de extensão públicos: a view/markup do formulário, os handlers que reagem aos eventos de ciclo de vida do formulário (ex.: carga e validação) e aos eventos de campos (validação e reação a mudanças). Veja também a seção "Estrutura de um Projeto Fluig Studio": o form fica em
forms/e seus eventos emforms/events/. - conventions.md — Convenções de Form: contêiner
fluig-style-guide,<form>nomeado, ordem de scripts/estilos no<head>, scripts inline antes de</body>, atributonameobrigatório nos campos, i18n de formulários (i18n.translate("chave")no HTML e em eventos, 3 arquivos.propertiespor locale, codificação\uXXXX), JavaScript em ES6+ e segurança (WCMAPI.validateXSS/DOMPurify.sanitize).
⚠️ Atenção: o i18n de formulários usa
i18n.translate("chave")— mecanismo completamente diferente do i18n de widgets/layouts (${i18n.getTranslation(...)}). Nunca misture os dois padrões.
Regras Aplicáveis (Resumo Executivo)
Somente o mínimo para orientar a geração; o detalhe está no contexto:
- A view/markup envolve os campos em
fluig-style-guide+<form>nomeado; CSS/libs no<head>, scripts inline antes de</body>→ verconventions.md. - Todo campo tem o atributo
name(obrigatório para o Fluig gravar/ler o valor);id,for,placeholdersão recomendados por semântica/acessibilidade → verconventions.md. - Pai x Filho (quando aplicável): declarar a tabela com
tablenameno<table>, manter uma linha-base no<tbody>e deixar o Fluig gerar as linhas com sufixo___<indice>→ verconventions.md. - Adicionar/remover filhos: usar
wdkAddChild("<tablename>")ewdkRemoveChild(...)sem manipular índice manualmente → verconventions.md. - Consumo via dataset: para consultar a tabela filha, filtrar por
documentid,tablenameemetadata#active→ verconventions.md. - O desenvolvedor implementa handlers nos eventos públicos do formulário (ciclo de vida e campos) → ver
architecture.md. - i18n — HTML: todo texto exibido ao usuário usa
i18n.translate("chave"). Nunca gerar texto fixo em elementos visíveis → verconventions.md. - i18n — Eventos JS: mensagens em handlers usam
i18n.translate("chave")— chave sempre entre aspas duplas. Em variável:var t = 'i18n.translate("chave")'; em template literal:placeholder="i18n.translate("chave")". Nunca strings literais → verconventions.md. - i18n — Arquivos: gerar obrigatoriamente os 3 arquivos
.properties(_pt_BR,_en_US,_es). Todas as chaves do HTML e dos eventos devem estar presentes nos 3 arquivos → verconventions.md. - i18n — Codificação: todos os 3 arquivos
.propertiesseguem padrão Java Properties; nenhum caractere não-ASCII diretamente — usar\uXXXX→ verconventions.md. - Chaves descritivas em dot-notation:
customer.name,validation.required.field→ verconventions.md. - JavaScript em ES6+ (
const/let, arrow functions); evitarvar→ verconventions.md. - Validar e sanitizar toda entrada do usuário (
WCMAPI.validateXSS/DOMPurify.sanitize) → verconventions.md.
Procedimento
- Definir o nome do formulário em camelCase (ex.:
registroIncidenteTI) — ele será usado como nome do arquivo HTML e como prefixo dos 3 arquivos.properties. O nome do.htmle o prefixo dos.propertiesdevem ser **exatam