Saltar al contenido principal

Message

Abrir en ChatGPT
Sombra 24.02
Java API

Un MessageDialog es un cuadro de diálogo modal diseñado para mostrar un mensaje al usuario con un botón OK para cerrar el cuadro de 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​

Utiliza el método estático showMessageDialog para mostrar un mensaje básico.

OptionDialog.showMessageDialog("¡Hola Mundo!");

Para tener más control sobre la apariencia y el comportamiento del cuadro de diálogo, crea una instancia de MessageDialog directamente.

MessageDialog dialog = new MessageDialog(
  "¡Hola Mundo!", "¡Hola Mundo!", MessageDialog.MessageType.INFO);
dialog.setBlurred(true);
dialog.setAlignment(MessageDialog.Alignment.TOP);
dialog.show();

Tipo de mensaje​

El MessageDialog admite los siguientes tipos de mensaje. Cuando configuras un tipo, el cuadro de diálogo muestra un ícono junto al mensaje y el tema del cuadro de 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 mensaje de tipo WARNING con un título y un mensaje personalizados.

Mostrar Código

Tema del cuadro de diálogo y botones

Por defecto, el cuadro de diálogo determina el tema en función del tipo de mensaje. Puedes personalizar el tema del cuadro de diálogo utilizando el método setTheme(Theme theme) y ajustar de forma independiente el tema del botón con el método setButtonTheme(ButtonTheme theme) para crear diferentes variaciones.

Texto del botón​

Puedes configurar el texto del botón del cuadro de diálogo utilizando el setButtonText(String text).

OptionDialog.showMessageDialog("¡Hola Mundo!", "Título", "Entendido");

Procesamiento de HTML​

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

MessageDialog dialog = new MessageDialog(
  "<b>¡Hola Mundo!</b>", "¡Hola Mundo!", MessageDialog.MessageType.INFO);
dialog.setRawText(true);
dialog.show();

Tiempo de espera​

El MessageDialog te permite establecer una duración de tiempo de espera después de la cual el cuadro de diálogo se cierra automáticamente. Esta función es útil para notificaciones o información no crítica que no requiere la interacción inmediata del usuario.

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

MessageDialog dialog = new MessageDialog("Este cuadro de diálogo se cerrará pronto", "Tiempo de espera");
dialog.setTimeout(2);
dialog.show();

Mejores prácticas​

  1. Mensajes claros y concisos: Mantén los mensajes cortos y directos, y evita jerga técnica; usa un lenguaje amigable para el usuario.
  2. Tipos de mensaje apropiados:
    • Utiliza ERROR para problemas críticos.
    • Utiliza WARNING para avisos de precaución.
    • Utiliza INFO para información general.
  3. Tematización consistente: Alinea los temas de los cuadros de diálogo y botones con el diseño de tu aplicación.
  4. Uso juicioso del tiempo de espera: Establece tiempos de espera para notificaciones no críticas y asegúrate de que los usuarios tengan suficiente tiempo para leer el mensaje.
  5. Evitar el uso excesivo: Utiliza cuadros de diálogo con moderación para evitar la frustración del usuario y resérvalos para mensajes importantes que requieran acción o reconocimiento del usuario.