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
POSTePUTcriam campos de entrada para envio de dados. - O tratamento de eventos básico, como interações
OnSuccesseOnError, é 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ário | Tipo padrão | Notas |
|---|---|---|
| Grupo de opções | Booleano | Falta validação de campo obrigatório |
| Caixa de seleção | Booleano | Falta validação de campo obrigatório |
| Alternador | Booleano | - |
| Controle deslizante | Número | - |
| Seleção | Enumeração | - |
| Caixa Combo | Enumeração | - |
| Selecionador de data | Data | - |
| Calendário | Data | Pode não atualizar a data selecionada com precisão |
| Campo de entrada | String, 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-hintem preview: O elementoigx-hintestá 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.
