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
POSTyPUTcrean campos de entrada para el envío de datos. - La manipulación básica de eventos, como las interacciones
OnSuccessyOnError, 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 formulario | Tipo predeterminado | Notas |
|---|---|---|
| Grupo de opciones | Booleano | Carece de validación de campo requerido |
| Casilla de verificación | Booleano | Carece de validación de campo requerido |
| Conmutador | Booleano | - |
| Deslizador | Número | - |
| Seleccionar | Enumeración | - |
| Cuadro combinado | Enumeración | - |
| Selector de fecha | Fecha | - |
| Calendario | Fecha | Puede no actualizar la fecha seleccionada con precisión |
| Campo de entrada | Cadena, 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-hinten Vista previa: El elementoigx-hintse 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.
