Uso de validación de entrada necesaria

Información en segundo plano

Puedes usar validación de entrada requerida para notificar al usuario en tiempo de ejecución que es obligatoria la entrada en un control estableciendo la propiedad Requerido como =true. También puedes configurar un mensaje de error si el control no se rellena en tiempo de ejecución usando la propiedad Mensaje de error obligatorio.

Puedes añadir texto al lado del control usando la nueva propiedad Etiqueta. Puedes colocar la etiqueta por encima o a la izquierda del control usando la propiedad Colocación de etiqueta en la pestaña Estilo.

Esta propiedad está disponible actualmente para los siguientes controles de entrada:

• Selector de fechas
• Lista desplegable
• Selector de archivos
• Lista desplegable de selección múltiple
• Botón de radio
• Control deslizante
• Área de texto
• Cuadro de texto

Nota:

El control Contenedor también tiene una propiedad isValid .

La propiedad isValid para el control Contenedor se aplica a todas las partes de controles del contenedor.

Para obtener más información al respecto, consulta la página Validación de contenedor.

En el siguiente ejercicio construiremos un formulario sencillo con validación de entrada requerida. Puedes usar este ejercicio para comprender mejor cómo funciona validación de entrada requerida y aprender cómo usarla de forma eficiente en tus aplicaciones.

Creación de un formulario usando validación de entrada requerida

Pasos

1. Abre tu aplicación ya existente o inicia una nueva.

2. Añade un nuevo control Botón a tu aplicación.

   • Añade Subscribe en la propiedad Texto.

3. Añade una página nueva en blanco a la aplicación.

   • Cambia el nombre de la página a Página de suscripción.

4. Añade un control de visualización de Encabezado en la parte superior de la página.

   • Añade Subscribe to this app en la propiedad Texto.

5. Añade un control de Cuadro de texto bajo el encabezado.

   • Cámbiale el nombre a Name.
   • Añade Name: en la propiedad Etiqueta.
   • Establece la propiedad Requerido de la Validación como =true.

6. Añade un control Cuadro de texto bajo el cuadro de texto Nombre.

   • Cámbiale el nombre a Email.
   • Añade Email: en la propiedad Etiqueta.
   • Establece la propiedad Requerido de la Validación como =true.

7. Añade un control Selector de fechas bajo el último cuadro de texto.

   • Cámbiale el nombre a Date of birth.
   • Añade Date of birth: en la propiedad Etiqueta.
   • Establece la propiedad Requerido de la Validación como =true.
     
     

     

     
     
     Nota:

     Cada uno de estos controles tiene una propiedad IsValid. Esta propiedad nos indicará si el control es válido o no.

     De forma predeterminada, cuando la propiedad Requerido de un control se establece como =true, el control no será válido.

     Gráfico 1 ..

8. Añade un control Botón bajo el selector de fechas.

   • Añade Submit en la propiedad Texto.
   • En la propiedad Deshabilitado, usa la propiedad isValid de los controles configurados previamente para construir la siguiente expresión: =! Name.isValid || !Email.isValid || !Date of birth.isValid.
     
     

     

     
     

9. Ve al botón Suscribir de la Página principal y configura el evento Pulsado en.

   • Añade una regla Abrir una página.
   • Añade la Página de suscripción en el campo Qué página abrir.

   • Marca la casilla de verificación Mostrar como emergente (modal).

     
     

     

     
     

Resultados del procedimiento

Después de seguir todos los pasos anteriores, puedes previsualizar la aplicación.

En el modo de vista previa, si haces clic en el botón Suscribir se abrirá la Página de suscripción. Observa que el botón Enviar está deshabilitado y solo se habilita cuando se rellenan todos los campos requeridos.

Nota:

Si escribes un valor en cualquier campo y luego lo eliminas, aparece un mensaje de error y el botón se deshabilita otra vez.