Skip to content

Visão Geral do Form Builder

A funcionalidade Form Builder do App Builder permite que desenvolvedores projetem formulários HTML através de uma experiência de arrastar e soltar. Ela enfatiza a geração automática de estruturas de formulário diretamente de endpoints de API, simplificando o processo de criação e permitindo conexões de dados perfeitas com fontes de backend. Este recurso oferece ampla flexibilidade no layout do formulário, personalização de componentes, e inclui opções para exibir notificações de envios, erros e validações do lado do servidor.

Recursos Principais do Form Builder

Geração automática de formulário a partir de endpoints de dados

Quando um desenvolvedor arrasta um endpoint de dados para a superfície de design, um conjunto de componentes de formulário é gerado automaticamente com base nas propriedades do endpoint.

  • Os métodos POST e PUT criam campos de entrada para envio de dados.
  • O tratamento de eventos básico, como interações OnSuccess e OnError, é configurado automaticamente.

Criação automática de formulário

Criação e mapeamento automáticos de controles de formulário

Os controles de formulário são criados com base no tipo de dados e metadados de cada campo, garantindo entradas e rótulos intuitivos (por exemplo, campos de data usam seletores de data, campos booleanos usam alternadores). Os desenvolvedores mantêm controle total para modificar componentes, adicionar validações ou ajustar rótulos diretamente no painel de propriedades.

Criação automática de controles de formulário

Modificação de formulário

Uma vez gerado, o formulário pode ser editado para incluir ou excluir campos, personalizar rótulos e definir validações de entrada, oferecendo uma experiência de design intuitiva. O App Builder permite que desenvolvedores personalizem tanto o layout quanto os componentes do formulário:

  • Adicione ou remova facilmente elementos dentro do formulário.
  • Ajuste propriedades de controle como validações Obrigatório e Desabilitado, personalização de rótulos e mapeamento.

Modificações de formulário

Interação ao vivo com formulários

No modo Preview do App Builder, os usuários podem interagir com formulários para ver:

  • Validação de entrada em tempo real.
  • Envio de formulário, com notificações indicando sucesso ou erros de validação.

Configurando variáveis e estado inicial do formulário

Note

Após o envio do formulário no modo Preview, a ação Post/Put é executada, adicionando ou atualizando o registro através do endpoint especificado.

Botões de ação configuráveis

Os botões de ação (Submit, Reset) oferecem personalização completa, suportando colocações dentro e fora do formulário. Esta flexibilidade é essencial para desenvolvedores que precisam de controle preciso sobre o comportamento do formulário em layouts mais complexos.

Configurando botões de ação

Notificações de ação de envio

Mensagens de sucesso e erro são exibidas via Snackbars, oferecendo feedback discreto sobre envios de formulário. Essas notificações são codificadas para a versão inicial, com planos para suportar tratamento de interação flexível em iterações futuras.

Suporte a Controles de Formulário

O Form Builder suporta uma variedade de controles de interface do usuário mapeados para tipos de dados específicos, garantindo que os desenvolvedores possam criar formulários acessíveis e responsivos com eficiência. Abaixo está um resumo dos controles suportados e limitações atuais.

Controle de formulárioTipo padrãoNotas
Grupo de opçõesBooleanoFalta validação de campo obrigatório
Caixa de seleçãoBooleanoFalta validação de campo obrigatório
AlternadorBooleano-
Controle deslizanteNúmero-
SeleçãoEnumeração-
Caixa ComboEnumeração-
Selecionador de dataData-
CalendárioDataPode não atualizar a data selecionada com precisão
Campo de entradaString, Número-
Note

Os controles de formulário atualmente suportam propriedades de validação básica (Obrigatório, Desabilitado).

Todos os controles de formulário suportam vinculação bidirecional e estão vinculados ao contexto do formulário.

Melhorias futuras

O roadmap para o Form Builder do App Builder inclui avanços na criação manual de formulários, opções de validação, suporte estendido de metadados e tratamento aprimorado de notificações e interações.

Os aprimoramentos de validação futuro incluirão:

  • Validação de intervalo (min, max).
  • Validação de comprimento de string (min length, max length).
  • Validação de padrão (regex).
  • Validação de enumeração para controles select e combo box

Problemas conhecidos e limitações

As seguintes limitações e problemas conhecidos se aplicam à versão inicial do Form Builder, lançada em 28 de outubro:

  • Discrepância de comportamento do reset de formulário entre a experiência de runtime do App Builder e a runtime do aplicativo gerado:
    • No App Builder, o clique no botão Reset reverte para os valores iniciais ao editar um registro e limpa o formulário ao adicionar um novo registro.
    • No aplicativo gerado, o clique no botão Reset limpa o formulário configurando todos os controles de formulário como valores vazios.
  • Cópia e colagem de formulário: Copiar e colar um formulário atualmente resulta na perda de vinculações de dados do formulário original, que são transferidas para a instância do formulário recém-colada.
  • Sinalizador obrigatório booleano: Há ambiguidade na implementação de um campo booleano obrigatório, particularmente para casos como “aceitar termos de serviço”.
  • Comportamento de envio/reset: A funcionalidade de envio/reset foi adaptada para funcionar em formulários de template e reativos, mas ainda pode ter inconsistências.
  • Geração de código:
    • Problemas de digitação com modelos de formulário: Inconsistências de digitação podem surgir, especialmente ao trabalhar com estruturas aninhadas ou matrizes, complicando a geração precisa do modelo de formulário no código de saída.
    • Elemento igx-hint em preview: O elemento igx-hint está atualmente excluído do preview, pois não é gerado no código final. Atualizações futuras podem adicionar suporte para funcionalidade de exibição de mensagens.
    • Calendário não aparece no aplicativo gerado quando em um formulário.
    • Comportamento do clique no botão de reset - ele limpa o formulário para projetos React gerados. Em vez de reverter para valores iniciais, os controles de formulário recebem valores vazios.
    • Propriedade desabilitada não será renderizada para entrada em um formulário Angular gerado.

Recursos adicionais