跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

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

EntradaDescriçãoObrigatória
Nome do formulárioIdentificador camelCase do formulário — usado como nome do arquivo HTML e como prefixo dos arquivos .properties (ex.: registroIncidenteTI)sim
CamposLista de campos do formulário (nome, tipo e se é obrigatório)sim
Regras de validaçãoRegras de preenchimento/consistência por campo ou para o formulárionã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 em forms/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>, atributo name obrigatório nos campos, i18n de formulários (i18n.translate("chave") no HTML e em eventos, 3 arquivos .properties por 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> → ver conventions.md.
  • Todo campo tem o atributo name (obrigatório para o Fluig gravar/ler o valor); id, for, placeholder são recomendados por semântica/acessibilidade → ver conventions.md.
  • Pai x Filho (quando aplicável): declarar a tabela com tablename no <table>, manter uma linha-base no <tbody> e deixar o Fluig gerar as linhas com sufixo ___<indice> → ver conventions.md.
  • Adicionar/remover filhos: usar wdkAddChild("<tablename>") e wdkRemoveChild(...) sem manipular índice manualmente → ver conventions.md.
  • Consumo via dataset: para consultar a tabela filha, filtrar por documentid, tablename e metadata#active → ver conventions.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 → ver conventions.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 → ver conventions.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 → ver conventions.md.
  • i18n — Codificação: todos os 3 arquivos .properties seguem padrão Java Properties; nenhum caractere não-ASCII diretamente — usar \uXXXX → ver conventions.md.
  • Chaves descritivas em dot-notation: customer.name, validation.required.field → ver conventions.md.
  • JavaScript em ES6+ (const/let, arrow functions); evitar var → ver conventions.md.
  • Validar e sanitizar toda entrada do usuário (WCMAPI.validateXSS/DOMPurify.sanitize) → ver conventions.md.

Procedimento

  1. 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 .html e o prefixo dos .properties devem ser **exatam
阅读完整来源 ↗