# Description List

A semantic key/value list (term/description) — horizontal or vertical, with an optional bordered style.

- Install: `php artisan blatui:add description-list`
- Source: https://blatui.remix-it.com/r/description-list.json
- Composer: `composer require gehrisandro/tailwind-merge-laravel`

## resources/views/components/ui/description-list.blade.php

```blade
@props([
    'layout' => 'horizontal',  // horizontal | vertical
    'bordered' => false,
])

@php
    // `bordered` wraps the rows in a card surface with dividers between them.
    // Otherwise rows simply stack with a comfortable vertical gap.
    $classes = $bordered
        ? 'bg-card text-card-foreground divide-border rounded-xl border divide-y'
        : 'flex flex-col gap-4';
@endphp

<dl data-slot="description-list" {{ $attributes->twMerge($classes) }}>
    {{ $slot }}
</dl>
```