Docs / Components

SenseBlockUiComponent

Overlay from @artificialsenselabs/ui that blocks interaction with projected content while exposing a loading status region.

Live demo: run nx serve showcase and open /components/block-ui (port 4202).

Overview

Category: Display. Selector: sense-block-ui. Import: import { SenseBlockUiComponent } from '@artificialsenselabs/ui';

<sense-block-ui [blocked]="saving()">
  <form>...</form>
  <div blockTemplate>
    <sense-spinner />
  </div>
</sense-block-ui>

Inputs

InputTypeDefaultDescription
blockedboolean (model)falseWhen true, blocks pointer interaction and shows the loading mask.
styleClassstring | nullnullExtra CSS class names on the host.
baseZIndexnumber0Inline z-index for the mask; 0 keeps the token default.
loadingLabelstring | nullnullAccessible name for the mask; falls back to block-ui.loading i18n.

Accessibility

  • When blocked, projected content receives inert and the host sets aria-busy.
  • The mask uses role="status" with aria-live="polite".
  • Project custom loading UI via the blockTemplate slot.