Saltar al contenido principal

Input Dialog

Abrir en ChatGPT
Sombra 24.02
Java API

Un InputDialog es un cuadro de diálogo modal diseñado para solicitar la entrada del usuario. El diálogo bloquea la ejecución de la aplicación hasta que el usuario proporciona la entrada o cierra el diálogo.

Usos​

El InputDialog solicita a los usuarios que ingresen datos, como texto, números u otra información. Debido a que el diálogo es modal, la aplicación espera que el usuario responda antes de continuar:

Mostrar Código

Tipos​

Tipos de entrada​

El InputDialog admite diferentes tipos de campos de entrada, lo que le permite adaptar el método de entrada a sus necesidades específicas:

  1. TEXTO: Un campo de entrada de texto de una sola línea estándar.
  2. CONTRASEÑA: Un campo de entrada de contraseña que oculta la entrada del usuario.
  3. NÚMERO: Un campo de entrada numérico.
  4. CORREO ELECTRÓNICO: Un campo de entrada para direcciones de correo electrónico.
  5. URL: Un campo de entrada para URL.
  6. BÚSQUEDA: Un campo de entrada de texto de búsqueda.
  7. FECHA: Un campo de entrada para seleccionar fechas.
  8. HORA: Un campo de entrada para seleccionar la hora.
  9. FECHA_HORA_LOCAL: Un campo de entrada para seleccionar la fecha y hora local.
  10. COLOR: Un campo de entrada para seleccionar un color.

Tipo de mensaje​

El InputDialog admite los siguientes tipos de mensajes. Cuando configuras un tipo, el diálogo muestra un ícono junto al mensaje y el tema del diálogo se actualiza de acuerdo con las reglas del sistema de diseño de webforJ.

  1. PLAIN: Muestra el mensaje sin un ícono, utilizando el tema predeterminado.
  2. ERROR: Muestra un ícono de error junto al mensaje con el tema de error aplicado.
  3. QUESTION: Muestra un ícono de signo de interrogación junto al mensaje, utilizando el tema primario.
  4. WARNING: Muestra un ícono de advertencia junto al mensaje con el tema de advertencia aplicado.
  5. INFO: Muestra un ícono de información junto al mensaje, utilizando el tema de información.

En el siguiente ejemplo, se solicita al usuario que ingrese su contraseña para acceder a la aplicación. Si el inicio de sesión fracasa, se le pedirá al usuario nuevamente.

Mostrar Código

Resultado​

El InputDialog devuelve la entrada del usuario como una cadena. Si el usuario cierra el diálogo sin proporcionar entrada, el resultado será null.

important

La cadena resultante será devuelta desde el método show(), o el equivalente método OptionDialog como se muestra a continuación.

String result = OptionDialog.showInputDialog(
  "Por favor ingresa tu edad:", "Entrada de Edad", "", InputDialog.InputType.NUMBER);

if (result != null) {
  OptionDialog.showMessageDialog("Ingresaste: " + result, "Entrada Recibida");
} else {
  OptionDialog.showMessageDialog("No se recibió entrada", "Entrada Cancelada");
}

Valor predeterminado​

El InputDialog te permite especificar un valor predeterminado que aparece en el campo de entrada cuando se muestra el diálogo. Esto puede proporcionar a los usuarios una sugerencia o un valor previamente ingresado.

InputDialog dialog = new InputDialog(
  "Por favor ingresa tu nombre:", "Entrada de Nombre", "John Doe", InputDialog.InputType.TEXT);
String result = dialog.show();

Tiempo de espera​

El InputDialog te permite establecer una duración de tiempo de espera después de la cual el diálogo se cierra automáticamente. Esta función es útil para solicitudes de entrada o acciones no críticas que no requieren la interacción inmediata del usuario.

Puedes configurar el tiempo de espera para el diálogo usando el método setTimeout(int timeout). La duración del tiempo de espera está en segundos. Si se agota el tiempo especificado sin ninguna interacción del usuario, el diálogo se cierra automáticamente.

InputDialog dialog = new InputDialog(
  "Por favor ingresa tu nombre:", "Entrada de Nombre", "John Doe");
dialog.setTimeout(5);
String result = dialog.show();

OptionDialog.showMessageDialog(
  "Ingresaste: " + result, "Entrada Recibida", "OK", MessageDialog.MessageType.INFO);

Mejores prácticas​

  1. Solicitudes Claras y Concisas: Asegúrate de que el mensaje de solicitud explique claramente qué información se le pide al usuario.
  2. Tipos de Entrada Apropiados: Elige tipos de entrada que se correspondan con los datos requeridos para garantizar una entrada de usuario precisa y relevante.
  3. Valores Predeterminados Lógicos: Establece valores predeterminados que proporcionen sugerencias útiles o entradas anteriores para agilizar la entrada del usuario.
  4. Uso Juicioso del Tiempo de Espera: Establece tiempos de espera para solicitudes de entrada no críticas, asegurando que los usuarios tengan suficiente tiempo para proporcionar la información requerida.
  5. Minimizar el Uso Excessivo: Usa diálogos de entrada con moderación para evitar frustraciones en el usuario. Resérvalos para acciones que requieren una entrada específica del usuario.