Passer au contenu principal

Loading

Ouvrir dans ChatGPT
Ombre dwc-loading 24.10
Java API

Le composant Loading affiche une superposition sur un composant spécifique ou une zone, signalant qu'une opération est en cours et bloquant temporairement l'interaction. Il fonctionne bien pour des tâches telles que le chargement de données, les calculs ou les processus en arrière-plan. Pour les processus globaux de l'application, le composant BusyIndicator couvre plutôt l'ensemble de l'interface.

Bases​

La manière la plus simple de créer un composant Loading est de l'initialiser sans aucun paramètre supplémentaire. Par défaut, cela affiche un simple spinner sur son contenu parent. Toutefois, vous pouvez également fournir un message pour plus de contexte.

Voici un exemple de création d'un composant Loading avec un message :

Afficher le code

Portée​

Le composant Loading dans webforJ peut se limiter à un conteneur parent spécifique, tel qu'un Div, garantissant qu'il ne bloque que l'interaction de l'utilisateur à l'intérieur de cet élément. Par défaut, le composant Loading est relatif à son parent, ce qui signifie qu'il superpose le composant parent plutôt que l'ensemble de l'application.

Pour limiter le composant Loading à son parent, il suffit d'ajouter le composant Loading au conteneur parent. Par exemple, si vous l'ajoutez à un Div, la superposition de chargement s'applique uniquement à ce Div :

Div parentDiv = new Div();  
parentDiv.setStyle("position", "relative");
Loading loading = new Loading();
parentDiv.add(loading);
loading.open();  // Le chargement ne bloquera que l'interaction à l'intérieur du parentDiv

Arrière-plan​

Le composant Loading dans webforJ vous permet d'afficher un arrière-plan pour bloquer l'interaction de l'utilisateur pendant qu'un processus est en cours. Par défaut, le composant active l'arrière-plan, mais vous avez la possibilité de le désactiver si nécessaire.

Pour le composant Loading, l'arrière-plan est visible par défaut. Vous pouvez l'activer ou le désactiver explicitement en utilisant la méthode setBackdropVisible() :

Loading loading = new Loading();
loading.setBackdropVisible(false);  // Désactive l'arrière-plan
loading.open();
Arrière-plan désactivé

Même lorsque vous désactivez l'arrière-plan, le composant Loading continue de bloquer l'interaction de l'utilisateur pour garantir que le processus sous-jacent se termine sans interruption. L'arrière-plan contrôle simplement la superposition visuelle, pas le blocage de l'interaction.

Spinner​

Le composant Loading dans webforJ comprend un Spinner qui indique visuellement qu'un processus en arrière-plan est en cours. Vous pouvez personnaliser ce spinner avec plusieurs options, y compris sa taille, sa vitesse, sa direction, son thème et sa visibilité.

Voici un exemple de la façon dont vous pouvez personnaliser le spinner dans un composant Loading :

Afficher le code

Cas d'utilisation​

  • Récupération de données
    Lors de la récupération de données à partir d'un serveur ou d'une API, le composant Loading superpose une section spécifique de l'interface utilisateur, comme une carte ou un formulaire, pour informer les utilisateurs que le système fonctionne en arrière-plan. Cela est idéal lorsque vous souhaitez montrer le progrès sur une seule partie de l'écran sans bloquer l'ensemble de l'interface.

  • Chargement de contenu dans des cartes/sections
    Le composant Loading peut être limité à des zones spécifiques d'une page, telles que des cartes ou conteneurs individuels. Cela est utile lorsque vous souhaitez indiquer qu'une section particulière de l'interface utilisateur est encore en cours de chargement tout en permettant aux utilisateurs d'interagir avec d'autres parties de la page.

  • Soumissions de formulaires complexes
    Pour les soumissions de formulaires plus longues où la validation ou le traitement prend du temps, le composant Loading fournit un retour visuel aux utilisateurs, les rassurant que leur saisie est en cours de traitement.

Style​

Loading...