Skip to content

Descripción general de Form Builder

La funcionalidad Form Builder de App Builder permite a los desarrolladores diseñar formularios HTML mediante una experiencia de arrastrar y soltar. Hace hincapié en la generación automática de estructuras de formularios directamente desde puntos finales de API, lo que simplifica el proceso de creación y permite conexiones de datos sin problemas con fuentes backend. Esta función ofrece una flexibilidad considerable en el diseño del formulario, la personalización de componentes e incluye opciones para mostrar notificaciones de envíos, errores y validaciones del lado del servidor.

Características principales de Form Builder

Generación automática de formularios a partir de puntos finales de datos

Cuando un desarrollador arrastra un punto final de datos a la superficie de diseño, se genera automáticamente un conjunto de componentes de formulario basados en las propiedades del punto final.

  • Los métodos POST y PUT crean campos de entrada para el envío de datos.
  • La manipulación básica de eventos, como las interacciones OnSuccess y OnError, se configura automáticamente.

Creación automática de formularios

Creación automática de controles de formulario y mapeo

Los controles del formulario se crean en función del tipo de datos y los metadatos de cada campo, lo que garantiza entradas e etiquetas intuitivas (por ejemplo, los campos de fecha utilizan selectores de fecha, los campos booleanos utilizan conmutadores). Los desarrolladores retienen el control total para modificar componentes, agregar validaciones o ajustar etiquetas directamente en el panel de propiedades.

Creación automática de controles de formulario

Modificación de formularios

Una vez generado, el formulario se puede editar para incluir o excluir campos, personalizar etiquetas y establecer validaciones de entrada, ofreciendo una experiencia de diseño intuitiva. App Builder permite a los desarrolladores personalizar tanto el diseño del formulario como los componentes:

  • Agregue o elimine fácilmente elementos dentro del formulario.
  • Ajuste las propiedades de control como validaciones Requerido y Deshabilitado, personalización de etiquetas y mapeo.

Modificaciones de formularios

Interacción en vivo con formularios

En el modo Vista previa de App Builder, los usuarios pueden interactuar con formularios para ver:

  • Validación de entrada en tiempo real.
  • Envío del formulario, con notificaciones que indican éxito o errores de validación.

Configuración de variables y estado inicial del formulario

Note

Al enviar el formulario en el modo Vista previa, se ejecuta la acción Post/Put, agregando o actualizando el registro a través del punto final especificado.

Botones de acción configurables

Los botones de acción (Enviar, Restablecer) ofrecen personalización completa, compatible con colocaciones dentro del formulario y externas. Esta flexibilidad es esencial para los desarrolladores que necesitan un control preciso sobre el comportamiento del formulario en diseños más complejos.

Configuración de botones de acción

Notificaciones de acción de envío

Los mensajes de éxito y error se muestran a través de Snackbars, proporcionando retroalimentación no intrusiva en los envíos de formularios. Estas notificaciones están codificadas para la versión inicial, con planes para admitir manejo de interacciones flexible en iteraciones futuras.

Compatibilidad de controles de formularios

Form Builder admite una variedad de controles de interfaz de usuario asignados a tipos de datos específicos, lo que garantiza que los desarrolladores puedan crear formularios accesibles y receptivos de manera eficiente. A continuación se muestra un resumen de los controles admitidos y las limitaciones actuales.

Control de formularioTipo predeterminadoNotas
Grupo de opcionesBooleanoCarece de validación de campo requerido
Casilla de verificaciónBooleanoCarece de validación de campo requerido
ConmutadorBooleano-
DeslizadorNúmero-
SeleccionarEnumeración-
Cuadro combinadoEnumeración-
Selector de fechaFecha-
CalendarioFechaPuede no actualizar la fecha seleccionada con precisión
Campo de entradaCadena, Número-
Note

Los controles de formulario actualmente admiten propiedades de validación básicas (Requerido, Deshabilitado).

Todos los controles de formulario admiten vinculación bidireccional y están vinculados al contexto del formulario.

Mejoras futuras

El mapa de ruta para Form Builder de App Builder incluye avances en la creación manual de formularios, opciones de validación, compatibilidad extendida con metadatos y manejo mejorado de notificaciones e interacciones.

Las mejoras futuras de validación incluirán:

  • Validación de rango (min, max).
  • Validación de longitud de cadena (min length, max length).
  • Validación de patrones (regex).
  • Validación de enumeración para controles de selección y cuadro combinado

Problemas conocidos y limitaciones

Las siguientes limitaciones y problemas conocidos se aplican a la versión inicial de Form Builder, lanzada el 28 de octubre:

  • Discrepancia de comportamiento de restablecimiento de formulario entre la experiencia de tiempo de ejecución de App Builder y la aplicación generada:
    • En App Builder, el clic del botón Restablecer revierte a los valores iniciales al editar un registro y borra el formulario al agregar un nuevo registro.
    • En la aplicación generada, el clic del botón Restablecer borra el formulario estableciendo todos los controles del formulario en valores vacíos.
  • Copiar y pegar formulario: Copiar y pegar un formulario actualmente resulta en que el formulario original pierda sus enlaces de datos, que se transfieren a la instancia de formulario recién pegada.
  • Bandera booleana requerida: Existe ambigüedad en la implementación de un campo booleano requerido, particularmente para casos como “aceptar términos de servicio”.
  • Comportamiento de envío/restablecimiento: La funcionalidad de envío/restablecimiento se ha adaptado para funcionar dentro de formularios de plantilla y reactivos, pero puede experimentar inconsistencias.
  • Generación de código:
    • Problemas de escritura con modelos de formulario: Las inconsistencias de escritura pueden surgir, especialmente cuando se trabaja con estructuras anidadas o matrices, lo que complica la generación precisa del modelo de formulario en el código de salida.
    • Elemento igx-hint en Vista previa: El elemento igx-hint se excluye actualmente de la vista previa ya que no se genera en el código final. Las actualizaciones futuras pueden agregar soporte para la funcionalidad de visualización de mensajes.
    • Calendario no se muestra en la aplicación generada cuando está en un formulario.
    • Comportamiento del clic del botón Restablecer: borra el formulario para proyectos generados con React. En lugar de revertir a valores iniciales, los controles del formulario obtienen valores vacíos.
    • Propiedad deshabilitada no se representará para la entrada en un formulario generado por Angular.

Recursos adicionales