Skip to page content

Inner Loading

The QInnerLoading component allows you to add a progress animation within a component. Much like the Loading Plugin, its purpose is to offer visual confirmation to the user that some process is happening in the background, which takes an excessive amount of time. QInnerLoading will add an opaque overlay over the delayed element along with a Spinner.

Usage

WARNING

In order for the spinner to be properly placed in the center of the element you want the loading display to show over, that element must have CSS position set to relative (or the relative-position CSS class declared).

WARNING

QInnerLoading must be the last element inside its parent so it can appear on top of the other content.

Basic

Basic



Label
v2.2+

You can add a label when using the default slot, but you can also use the “label” props instead:

Accessibility
v2.25+

QInnerLoading is a visual overlay only: the content it covers stays in the accessibility tree and remains focusable, and the loading state itself is never announced. Pass role="status" as an attribute and use the label prop so screen readers hear the state change, and manage the covered region yourself — set aria-busy="true" on it, or make it inert — when it shouldn’t be reachable while loading.