Saltar al contenido principal

Confirm

Abrir en ChatGPT
Sombra 24.02
Java API

Un ConfirmDialog es un cuadro de diálogo modal diseñado para permitir al usuario elegir una de un conjunto de hasta 3 opciones. El diálogo bloquea la ejecución de la aplicación hasta que el usuario interactúa con él o se cierra debido a un tiempo de espera.

Usos​

El ConfirmDialog proporciona una forma de pedir a los usuarios confirmación o elegir entre múltiples opciones, como Sí/No o Aceptar/Cancelar, asegurando que reconozcan y confirmen sus acciones.

Mostrar Código

Tipos​

Tipo de opción​

El ConfirmDialog admite los siguientes tipos de opción, que determinan los botones que se muestran en el diálogo:

  1. OK: Muestra un botón OK.
  2. OK_CANCEL: Muestra botones OK y Cancelar.
  3. ABORT_RETRY_IGNORE: Muestra botones Abortar, Reintentar e Ignorar.
  4. YES_NO_CANCEL: Muestra botones Sí, No y Cancelar.
  5. YES_NO: Muestra botones Sí y No.
  6. RETRY_CANCEL: Muestra botones Reintentar y Cancelar.
  7. CUSTOM: Muestra botones personalizados según lo especificado.

Tipo de mensaje​

El ConfirmDialog admite los siguientes tipos de mensaje. Cuando configuras un tipo, el diálogo muestra un ícono al lado del 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 al lado del 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 al lado del mensaje, utilizando el tema de información.

En el siguiente ejemplo, el código configura un cuadro de diálogo de confirmación del tipo CUSTOM con un título y mensaje personalizados.

Mostrar Código

Resultado​

El ConfirmDialog devuelve un resultado basado en la interacción del usuario con el diálogo. Este resultado indica qué botón hizo clic el usuario o si el diálogo se desestimó debido a un tiempo de espera.

important

El resultado será devuelto del método show(), o el método equivalente de OptionDialog como se muestra a continuación.

El enum ConfirmDialog.Result incluye los siguientes resultados posibles:

  1. OK: El usuario hizo clic en el botón OK.
  2. CANCEL: El usuario hizo clic en el botón CANCEL.
  3. YES: El usuario hizo clic en el botón YES.
  4. NO: El usuario hizo clic en el botón NO.
  5. ABORT: El usuario hizo clic en el botón ABORT.
  6. RETRY: El usuario hizo clic en el botón RETRY.
  7. IGNORE: El usuario hizo clic en el botón IGNORE.
  8. FIRST_CUSTOM_BUTTON: El usuario hizo clic en el primer botón personalizado.
  9. SECOND_CUSTOM_BUTTON: El usuario hizo clic en el segundo botón personalizado.
  10. THIRD_CUSTOM_BUTTON: El usuario hizo clic en el tercer botón personalizado.
  11. TIMEOUT: El diálogo se agota.
  12. UNKNOWN: Un resultado desconocido, generalmente usado como un estado predeterminado o de error.
if (result == ConfirmDialog.Result.FIRST_CUSTOM_BUTTON) {
  OptionDialog.showMessageDialog("Cambios descartados", "Descartado", "Entendido");
} else {
  OptionDialog.showMessageDialog(
    "Cambios guardados", "Guardado", "Entendido", MessageDialog.MessageType.INFO);
}

Botón predeterminado​

El ConfirmDialog te permite especificar un botón predeterminado que está preseleccionado cuando se muestra el diálogo. Esto mejora la experiencia del usuario al proporcionar una acción sugerida que puede confirmarse rápidamente presionando la tecla Enter.

ConfirmDialog dialog = new ConfirmDialog(
  "¿Estás seguro?", "Confirmar", ConfirmDialog.OptionType.YES_NO);
dialog.setDefaultButton(Button.SECOND); // segundo botón
dialog.show();

Texto de botones​

Puedes configurar el texto de los botones utilizando el método setButtonText(ConfirmDialog.Button button, String text).

ConfirmDialog dialog = new ConfirmDialog(
  "¿Estás seguro?", "Confirmar", ConfirmDialog.OptionType.CUSTOM);
dialog.setButtonText(ConfirmDialog.Button.FIRST, "Absolutamente");
dialog.setButtonText(ConfirmDialog.Button.SECOND, "Nope");
dialog.show();

Procesamiento de HTML​

Por defecto, el cuadro de diálogo de confirmación procesa y renderiza contenido HTML. Puedes desactivar esta función configurándolo para que muestre texto sin formato en su lugar.

ConfirmDialog dialog = new ConfirmDialog(
  "<b>¿Estás seguro?</b>", "Confirmar",
  ConfirmDialog.OptionType.YES_NO, ConfirmDialog.MessageType.QUESTION);
dialog.setRawText(true);
dialog.show();

Tiempo de espera​

El ConfirmDialog 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 confirmaciones o acciones no críticas que no requieren la interacción inmediata del usuario.

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

ConfirmDialog dialog = new ConfirmDialog(
    "¿Estás seguro?", "Confirmar", ConfirmDialog.OptionType.YES_NO);
dialog.setDefaultButton(Button.SECOND);
dialog.setTimeout(3);
ConfirmDialog.Result result = dialog.show();

switch (result) {
  case TIMEOUT:
    OptionDialog.showMessageDialog(
        "Te tardaste demasiado en decidir", "Tiempo de espera", "Entendido",
        MessageDialog.MessageType.WARNING);
    break;
  case YES:
    OptionDialog.showMessageDialog(
        "Hiciste clic en Sí", "Sí", "Entendido",
        MessageDialog.MessageType.INFO);
    break;
  default:
    OptionDialog.showMessageDialog(
        "Hiciste clic en No", "No", "Entendido",
        MessageDialog.MessageType.INFO);
    break;
}

Mejores prácticas​

  1. Solicitudes claras y concisas: Asegúrate de que el mensaje de solicitud explique claramente qué acción se le está pidiendo al usuario que confirme. Evita la ambigüedad.
  2. Tipos de opciones apropiados: Elige tipos de opciones que se correspondan con el contexto de la acción. Para decisiones simples de sí/no, utiliza opciones sencillas. Para escenarios más complejos, proporciona botones adicionales como "Cancelar" para permitir que los usuarios regresen sin tomar una decisión.
  3. Botón predeterminado lógico: Establece un botón predeterminado que se alinee con la acción más probable o recomendada del usuario para agilizar la toma de decisiones.
  4. Tematización consistente: Alinea el diálogo y los temas de los botones con el diseño de tu aplicación para una experiencia de usuario cohesiva.
  5. Uso juicioso del tiempo de espera: Establece tiempos de espera para confirmaciones no críticas, asegurando que los usuarios tengan suficiente tiempo para leer y entender la solicitud.
  6. Minimizar el uso excesivo: Usa cuadros de diálogo de confirmación con moderación para evitar la frustración del usuario. Resérvalos para acciones críticas que requieran la confirmación explícita del usuario.