Saltar al contenido

Toast

Abrir en ChatGPT
Shadow dwc-toast 24.10
Java API

Una notificación Toast es una notificación emergente sutil y poco intrusiva diseñada para proporcionar a los usuarios retroalimentación e información en tiempo real. Estas notificaciones se utilizan típicamente para informar a los usuarios sobre operaciones como acciones exitosas, advertencias o errores sin interrumpir su flujo de trabajo. Las notificaciones Toast generalmente desaparecen después de un tiempo establecido y no requieren una respuesta del usuario.

Con el componente Toast de webforJ, puedes implementar fácilmente estas notificaciones para mejorar la experiencia del usuario al proporcionar información relevante de una manera familiar, no intrusiva y fluida.

Basics

webforJ proporciona una forma rápida y sencilla de crear un componente Toast en una sola línea de código con el método Toast.show(), que crea un componente Toast, lo agrega al Frame y lo muestra. Puedes pasar parámetros al método show para configurar el Toast mostrado:

Toast.show("¡Operación completada con éxito!", Theme.SUCCESS);

Si deseas un control más detallado sobre el componente, también puedes crear un Toast con un constructor estándar y usar el método open() para mostrarlo.

Toast toast = new Toast("¡Operación completada con éxito!", 3000, Theme.SUCCESS, Placement.TOP);
toast.open();
Mostrar Código

Comportamiento por defecto

A diferencia de otros componentes, un Toast no necesita ser agregado explícitamente a un contenedor como un Frame. Cuando llamas al método open(), el Toast se adjunta automáticamente al primer Frame de la aplicación.

Los Toasts son versátiles y proporcionan notificaciones sutiles para retroalimentación en tiempo real. Por ejemplo:

  • Retroalimentación en tiempo real para acciones como envíos de formularios, guardado de datos o errores.
  • Temas personalizables para diferenciar entre mensajes de éxito, error, advertencia o informativos.
  • Opciones de colocación flexibles para mostrar notificaciones en diferentes áreas de la pantalla sin interrumpir el flujo de trabajo del usuario.

Duration

Puedes configurar las notificaciones Toast para que desaparezcan después de una duración establecida o persistan en la pantalla hasta que sean descartadas, dependiendo de tus necesidades. Puedes personalizar la duración con el método setDuration(), o simplemente suministrar un parámetro de duración al constructor o al método show().

Duración por defecto

Por defecto, un Toast se cierra automáticamente después de 5000 milisegundos.

Toast toast = new Toast("Notificación de muestra");
toast.setDuration(10000);
toast.open();

Toasts Persistentes

Puedes crear un Toast persistente estableciendo una duración negativa. Las notificaciones Toast persistentes no se cerrarán automáticamente, lo que puede ser útil para alertas críticas o en casos donde se requiera alguna interacción o reconocimiento por parte del usuario.

precaución

Ten cuidado con las notificaciones Toast persistentes, y asegúrate de proporcionar una forma para que el usuario descarte la notificación. Usa el método close() para ocultar el Toast una vez que el usuario lo haya reconocido o completado cualquier interacción requerida.

Toast toast = new Toast("¡Operación completada con éxito!", -1, Theme.SUCCESS, Placement.TOP);
toast.open();

Placement

Con el componente Toast de webforJ, puedes elegir dónde aparece la notificación en la pantalla para adaptarse al diseño y requisitos de usabilidad de tu aplicación. Por defecto, las notificaciones Toast aparecen en la parte inferior central de la pantalla.

Puedes establecer la placement de una notificación Toast con el método setPlacement usando el enumerador Toast.Placement con uno de los siguientes valores:

  • BOTTOM: Coloca la notificación en la parte inferior central de la pantalla.
  • BOTTOM_LEFT: Coloca la notificación en la esquina inferior izquierda de la pantalla.
  • BOTTOM_RIGHT: Coloca la notificación en la esquina inferior derecha de la pantalla.
  • TOP: Coloca la notificación en la parte superior central de la pantalla.
  • TOP_LEFT: Coloca la notificación en la esquina superior izquierda de la pantalla.
  • TOP_RIGHT: Coloca la notificación en la esquina superior derecha de la pantalla.

Estas opciones te permiten controlar la colocación de la notificación Toast según el diseño y las necesidades de usabilidad de tu aplicación.

Toast toast = new Toast("Notificación de muestra");
toast.setPlacement(Toast.Placement.TOP_LEFT);
toast.open();
Mostrar Código

Al personalizar la colocación de tus notificaciones Toast, puedes garantizar que los usuarios reciban información de manera adecuada para cualquier aplicación, diseño de pantalla y contexto dados.

Stacking

El componente Toast puede mostrar múltiples notificaciones simultáneamente, apilándolas verticalmente según su colocación. Las notificaciones más nuevas aparecen más cerca del borde de la colocación, empujando las notificaciones más antiguas más lejos. Esto asegura que los usuarios no se pierdan información importante, incluso cuando hay mucha actividad.

Actions and Interactivity

Aunque las notificaciones Toast no requieren interacción del usuario por defecto, webforJ te permite agregar botones u otros elementos interactivos para hacerlas más útiles que simples notificaciones.

Mostrar Código

Al agregar este tipo de interactividad, puedes dar a los usuarios la capacidad de manejar tareas y realizar acciones sin navegar lejos de su pantalla actual, transformando una notificación Toast en un canal valioso de interacción y compromiso.

Styling

Puedes estilizar las notificaciones Toast con temas, al igual que otros componentes de webforJ, proporcionando a los usuarios un contexto valioso sobre el tipo de información que se muestra y creando un estilo consistente en toda tu aplicación. Puedes establecer el tema al crear el Toast o usar el método setTheme().

Toast toast = new Toast("Notificación de muestra", Theme.INFO);
Toast toast = new Toast("Notificación de muestra");
toast.setTheme(Theme.INFO);

Temas Personalizados

Además de usar temas integrados, puedes crear tus propios temas personalizados para las notificaciones Toast. Esto permite una experiencia de usuario más personalizada y de marca, dándote control total sobre el estilo general del Toast.

Para agregar un tema personalizado a un Toast, puedes definir variables CSS personalizadas, que modifican la apariencia del componente. El siguiente ejemplo demuestra cómo crear un Toast con un tema personalizado usando webforJ.

Objetivo del Toast

Dado que el Toast no se encuentra en una posición específica en el DOM, puedes dirigirlo utilizando variables CSS. Estas variables facilitan la aplicación de estilos personalizados consistentes en todas las notificaciones Toast.

Mostrar Código

Loading...