Skip to content

Laravel Description List Component

Free · MIT

Key-value pair display for structured data like details, metadata, and summaries.

A Description List built for the TALL stack — Blade, Livewire 3 & 4, Alpine.js and Tailwind CSS 4. Server-rendered by default, dark-mode ready, and WCAG-minded. Drop it in with a single Blade tag: <x-aura::description-list>

Installation

composer require bluestarsystem/aura-ui

Usage

<x-aura::description-list>
    <x-aura::description-list.item label="Name" value="Jane Doe" />
    <x-aura::description-list.item label="Email" value="[email protected]" />
</x-aura::description-list>

See the full API, props and live examples in the Description List documentation.

Overview

The Description List component renders structured key-value data using semantic HTML <dl>, <dt>, and <dd> elements. It is ideal for displaying entity details, profile information, order summaries, or any data that follows a label-value pattern. Each item can use either a value prop or the default slot for rich content.

Use description lists for:

  • Customer or user profiles
  • Order and invoice details
  • Settings summaries
  • Metadata displays

Props

Description List

Prop Type Default Description
-- -- -- The wrapper accepts no specific props. Pass classes via class attribute.

Description List Item

Prop Type Default Description
label string '' The key/term displayed as <dt>
value string|null null The value displayed as <dd>. If null, the default slot is used.

Slots

Description List

Slot Description
Default Contains <x-aura::description-list.item> children

Description List Item

Slot Description
Default Rich content for the value. Used when value prop is null.

See more examples and every variant in the Description List documentation.

Laravel-native
No JavaScript framework. Pure Blade, Livewire & Alpine.
Dark mode & themeable
Tailwind 4 CSS variables and a visual Theme Studio.
Accessible
WCAG 2.1 AA-minded, keyboard and ARIA support.