Validaciones
Zelta Forms ofrece un sistema de validación que garantiza la calidad de los datos capturados. Desde campos obligatorios hasta patrones con expresiones regulares, cada campo puede configurarse con precisión.
Reglas de validación disponibles
Cada campo puede tener las siguientes reglas de validación:
| Regla | Propiedad | Aplica a | Descripción |
|---|---|---|---|
| Obligatorio | required | Todos los campos | Impide enviar el formulario si el campo está vacío |
| Longitud mínima | minLength | Texto corto, Texto largo | Cantidad mínima de caracteres |
| Longitud máxima | maxLength | Texto corto, Texto largo | Cantidad máxima de caracteres |
| Valor mínimo | min | Número, Calificación, Escala | Valor numérico mínimo permitido |
| Valor máximo | max | Número, Calificación, Escala | Valor numérico máximo permitido |
| Patrón (regex) | pattern | Texto corto, Email, Teléfono, URL | Expresión regular que el valor debe cumplir |
| Mensaje personalizado | customMessage | Todos | Mensaje de error personalizado para este campo |
Campo obligatorio
La regla más fundamental. Impide que el formulario se envíe si el campo está vacío.
- Selecciona el campo.
- En el panel derecho, activa Obligatorio.
- Personaliza el mensaje de error:
Mensaje predeterminado: "Este campo es obligatorio."
Mensaje personalizado: "Por favor, ingresa tu nombre completo."Longitud de texto
Controla la cantidad de caracteres permitidos:
| Regla | Ejemplo |
|---|---|
| Longitud mínima | minLength: 3 — Mínimo 3 caracteres |
| Longitud máxima | maxLength: 500 — Máximo 500 caracteres |
Rango numérico
Para campos numéricos, de calificación y escala, define los valores permitidos:
| Regla | Ejemplo |
|---|---|
| Valor mínimo | min: 18 — No menor a 18 |
| Valor máximo | max: 120 — No mayor a 120 |
Patrones (expresiones regulares)
Valida el formato de los datos con expresiones regulares. El campo pattern acepta cualquier regex válida.
Ejemplos comunes
| Caso de uso | Regex | Ejemplo válido |
|---|---|---|
| Solo letras | ^[a-zA-ZáéíóúÁÉÍÓÚñÑ\s]+$ | "María García" |
| Alfanumérico | ^[a-zA-Z0-9]+$ | "ABC123" |
| Código de producto | ^PROD-[A-Z]{2}-\d{4}$ | "PROD-MX-0123" |
| Teléfono internacional | ^\+\d{1,3}\s?\d{4,14}$ | "+507 63001234" |
| Código postal (5 dígitos) | ^\d{5}$ | "08001" |
Configurar un patrón
- Selecciona el campo.
- Ve a Validaciones > Patrón.
- Ingresa la expresión regular.
- Define un mensaje de error descriptivo que incluya un ejemplo del formato correcto.
Consejo
Siempre incluye un ejemplo del formato correcto en el mensaje de error. Esto reduce significativamente los errores del usuario. Por ejemplo: "La clave debe seguir el formato PROD-XX-0000 (ej. PROD-MX-0123)."
Mensajes de error personalizados
Cada regla de validación puede tener su propio mensaje de error mediante la propiedad customMessage:
| Regla | Mensaje predeterminado | Ejemplo personalizado |
|---|---|---|
| Obligatorio | "Este campo es obligatorio." | "Necesitamos tu email para contactarte." |
| Longitud mínima | "Mínimo {n} caracteres." | "Tu respuesta debe tener al menos 50 caracteres para ser útil." |
| Patrón | "El formato no es válido." | "Ingresa un correo electrónico válido (ej. )." |
| Rango | "El valor está fuera del rango." | "Selecciona un número entre 1 y 10." |
Configuraciones a nivel de formulario
Además de las validaciones por campo, el formulario tiene ajustes globales que afectan el comportamiento general:
| Configuración | Descripción |
|---|---|
| Barra de progreso | Muestra el avance del usuario al completar el formulario |
| Navegación hacia atrás | Permite regresar a preguntas anteriores |
| Mezclar campos | Aleatoriza el orden de los campos en cada sesión |
| Contraseña | Restringe el acceso al formulario con una contraseña |
Límites de plan
El número máximo de respuestas por mes se controla a nivel del plan de suscripción del workspace, no por formulario individual. Consulta los detalles de cada plan en la página de precios.