Skip to content

Empty State

The bq-empty-state component is a placeholder for empty content areas with icon, title, description, and an action slot.

Basic Usage

html
<bq-empty-state
  icon="📭"
  title="No messages"
  description="You haven't received any messages yet."
></bq-empty-state>

With Action Button

html
<bq-empty-state
  icon="🔍"
  title="No results"
  description="Try adjusting your search or filters."
>
  <bq-button variant="primary">Clear filters</bq-button>
</bq-empty-state>

Properties

PropertyTypeDefaultDescription
titlestringMain heading (falls back to an i18n default)
descriptionstringDescriptive text (falls back to an i18n default)
iconstringIcon character or emoji

Slots

SlotDescription
(default)Additional content such as action buttons

CSS Parts

PartDescription
empty-stateThe outer container
iconThe icon area
titleThe heading element
descriptionThe description paragraph
actionsThe actions/slot area

Accessibility

The component uses role="status" so assistive technology can announce the empty state.

Released under the MIT License.