Saltar al contenido principal

Loading

Abrir en ChatGPT
Sombra dwc-loading 24.10
Java API

El componente Loading muestra una superposición en un componente o área específica, señalando que una operación está en progreso y bloqueando temporalmente la interacción. Funciona bien para tareas como la carga de datos, cálculos o procesos en segundo plano. Para procesos globales de toda la aplicación, el componente BusyIndicator cubre toda la interfaz.

Inicializar un componente Loading sin ninguna configuración adicional muestra un spinner sobre su contenido padre. Pasa un mensaje, como en el ejemplo a continuación, cuando el proceso necesita más contexto.

Mostrar Código

Alcance​

El componente Loading en webforJ puede limitarse a un contenedor padre específico, como un Div, asegurando que solo bloquee la interacción del usuario dentro de ese elemento. Por defecto, el componente Loading es relativo a su padre, lo que significa que se superpone al componente padre en lugar de a toda la aplicación.

Para limitar el componente Loading a su padre, simplemente añade el componente Loading al contenedor padre. Por ejemplo, si lo añades a un Div, la superposición de carga se aplica solo a ese Div:

Div parentDiv = new Div();
parentDiv.setStyle("position", "relative");
Loading loading = new Loading();
parentDiv.add(loading);
loading.open();  // Loading solo bloqueará la interacción dentro de parentDiv

Fondo​

El componente Loading en webforJ te permite mostrar un fondo para bloquear la interacción del usuario mientras un proceso está en curso. Por defecto, el componente habilita el fondo, pero tienes la opción de desactivarlo si es necesario.

Para el componente Loading, el fondo es visible por defecto. Puedes habilitarlo explícitamente o desactivarlo utilizando el método setBackdropVisible():

Loading loading = new Loading();
loading.setBackdropVisible(false);  // Desactiva el fondo
loading.open();
Fondo desactivado

Incluso cuando desactivas el fondo, el componente Loading continúa bloqueando la interacción del usuario para asegurar que el proceso subyacente se complete sin interrupciones. El fondo simplemente controla la superposición visual, no el comportamiento de bloqueo de interacción.

Spinner​

El componente Loading en webforJ incluye un Spinner que indica visualmente que una operación en segundo plano está en progreso. Puedes personalizar este spinner con varias opciones, incluido su tamaño, velocidad, dirección, tema y visibilidad.

Aquí tienes un ejemplo de cómo puedes personalizar el spinner dentro de un componente Loading:

Mostrar Código

Casos de uso​

  • Recuperación de Datos Al recuperar datos de un servidor o API, el componente Loading superpone una sección específica de la UI, como una tarjeta o formulario, para informar a los usuarios que el sistema está trabajando en segundo plano. Esto es ideal cuando deseas mostrar el progreso en solo una parte de la pantalla sin bloquear toda la interfaz.

  • Carga de Contenido en Tarjetas/Secciones El componente Loading se puede limitar a áreas específicas de una página, como tarjetas individuales o contenedores. Esto es útil cuando deseas indicar que una sección particular de la UI todavía se está cargando mientras permites a los usuarios interactuar con otras partes de la página.

  • Envíos Complejos de Formularios Para envíos de formularios más largos donde la validación o el procesamiento lleva tiempo, el componente Loading proporciona retroalimentación visual a los usuarios, asegurándoles que su entrada está siendo procesada activamente.

Estilización​

Loading...