Overslaan naar hoofdinhoud

Loading

Openen in ChatGPT
Schaduw dwc-loading 24.10
Java API

De Loading-component toont een overlay op een specifiek component of gebied, waarmee wordt aangegeven dat een bewerking bezig is en tijdelijk interactie wordt geblokkeerd. Het werkt goed voor taken zoals gegevens laden, berekeningen of achtergrondprocessen. Voor wereldwijde, app-brede processen bedekt de BusyIndicator component de gehele interface.

Basisprincipes​

De eenvoudigste manier om een Loading-component te creëren is door het zonder extra instellingen te initialiseren. Standaard toont dit een basis-spinner bovenop de ouderinhoud. U kunt echter ook een bericht geven voor meer context.

Hier is een voorbeeld van het creëren van een Loading-component met een bericht:

Toon Code

Scoped​

De Loading-component in webforJ kan zich beperken tot een specifieke bovenliggende container, zoals een Div, zodat het alleen de interactie van de gebruiker binnen dat element blokkeert. Standaard is de Loading-component relatief ten opzichte van zijn bovenliggende element, wat betekent dat het de bovenliggende component bedekt in plaats van de gehele app.

Om de Loading-component te beperken tot zijn bovenliggende element, voegt u simpelweg de Loading-component toe aan de bovenliggende container. Bijvoorbeeld, als u het toevoegt aan een Div, geldt de laadoverlay alleen voor die Div:

Div parentDiv = new Div();  
parentDiv.setStyle("position", "relative");
Loading loading = new Loading();
parentDiv.add(loading);
loading.open();  // Loading blokkeert alleen de interactie binnen de parentDiv

Achtergrond​

De Loading-component in webforJ stelt u in staat om een achtergrond te tonen om de interactie van de gebruiker te blokkeren terwijl een proces aan de gang is. Standaard staat de component de achtergrond toe, maar u heeft de optie om deze uit te schakelen indien nodig.

Voor de Loading-component is de achtergrond standaard zichtbaar. U kunt deze expliciet in- of uitschakelen met de methode setBackdropVisible():

Loading loading = new Loading();
loading.setBackdropVisible(false);  // Schakelt de achtergrond uit
loading.open();
Achtergrond Uit

Zelfs als u de achtergrond uitschakelt, blijft de Loading-component de interactie van de gebruiker blokkeren om ervoor te zorgen dat het onderliggende proces onafgebroken wordt voltooid. De achtergrond regelt simpelweg de visuele overlay, niet het blokkeren van de interactie.

Spinner​

De Loading-component in webforJ bevat een Spinner die visueel aangeeft dat een achtergrondoperatie aan de gang is. U kunt deze spinner aanpassen met verschillende opties, waaronder grootte, snelheid, richting, thema en zichtbaarheid.

Hier is een voorbeeld van hoe u de spinner binnen een Loading-component kunt aanpassen:

Toon Code

Toepassingsgevallen​

  • Gegevens Ophalen
    Bij het ophalen van gegevens van een server of API, overlayt de Loading-component een specifiek gedeelte van de gebruikersinterface, zoals een kaart of formulier, om gebruikers te informeren dat het systeem op de achtergrond werkt. Dit is ideaal wanneer u voortgang op slechts één deel van het scherm wilt tonen zonder de gehele interface te blokkeren.

  • Inhoud Laden in Kaarten/Gedeelten
    De Loading-component kan worden beperkt tot specifieke gebieden van een pagina, zoals individuele kaarten of containers. Dit is nuttig wanneer u wilt aangeven dat een bepaald gedeelte van de gebruikersinterface nog aan het laden is, terwijl gebruikers met andere delen van de pagina kunnen interageren.

  • Complexe Formulierinzendingen
    Voor langere formulierinzendingen waar validatie of verwerking tijd kost, biedt de Loading-component visuele feedback aan gebruikers, waarmee bevestiging wordt gegeven dat hun invoer actief wordt verwerkt.

Stijlen​

Loading...