Saltar al contenido

Confirm Dialog

Abrir en ChatGPT
Shadow 24.02
Java API

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

ConfirmDialog.Result result = OptionDialog.showConfirmDialog(
    "¿Confirma?",
    "Confirmación",
    ConfirmDialog.OptionType.OK_CANCEL,
    ConfirmDialog.MessageType.QUESTION);

Usos​

El ConfirmDialog proporciona una manera de pedir a los usuarios confirmación o elegir entre múltiples opciones, como Sí/No o OK/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 cuadro de diálogo muestra un icono 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 icono, usando el tema predeterminado.
  2. ERROR: Muestra un icono de error junto al mensaje con el tema de error aplicado.
  3. QUESTION: Muestra un icono de signo de interrogación junto al mensaje, usando el tema primario.
  4. WARNING: Muestra un icono de advertencia junto al mensaje con el tema de advertencia aplicado.
  5. INFO: Muestra un icono de información junto al mensaje, usando el tema de información.

En el siguiente ejemplo, el código configura un cuadro de diálogo de confirmación de 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 se devolverá del método show(), o del 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, típicamente utilizado como 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 se selecciona por adelantado cuando se muestra el diálogo. Esto mejora la experiencia del usuario al proporcionar una acción sugerida que puede ser confirmada rápidamente presionando la tecla Enter.

ConfirmDialog dialog = new ConfirmDialog(
    "¿Está 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á seguro?", "Confirmar", ConfirmDialog.OptionType.CUSTOM);
dialog.setButtonText(ConfirmDialog.Button.FIRST, "Absolutamente");
dialog.setButtonText(ConfirmDialog.Button.SECOND, "No");
dialog.show();

Procesamiento HTML​

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

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

Tiempo de espera​

El ConfirmDialog permite configurar 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 interacción del usuario, el diálogo se cierra automáticamente.

ConfirmDialog dialog = new ConfirmDialog(
    "¿Está 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 tomó demasiado tiempo 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 pide al usuario que confirme. Evita la ambigüedad.
  2. Tipos de opción apropiados: Elige tipos de opción que coincidan con el contexto de la acción. Para decisiones simples de sí/no, utiliza opciones directas. Para escenarios más complejos, proporciona botones adicionales como "Cancelar" para permitir que los usuarios retrocedan 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 coherente.
  5. Uso juicioso del tiempo de espera: Configura tiempos de espera para confirmaciones no críticas, asegurando que los usuarios tengan tiempo suficiente para leer y comprender la solicitud.
  6. Minimizar el uso excesivo: Utiliza 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 una confirmación explícita por parte del usuario.