Indented Tree
A static nested outline rendering a tree as indented rows with guide lines, chevron/leaf markers and right-aligned meta.
Preview
A static, dependency-free nested outline. Pass `:items` — an array of nodes with a `label`, an optional `meta` (e.g. a count or size) and an optional `children[]` array — and it flattens depth-first into indented rows with guide lines.
Controls
Device view renders in an isolated frame so real responsive breakpoints apply. Switch to Full for overflowing popovers.
Installation
php artisan ui:add indented-tree
Registry contract
Install confidence
php artisan ui:add indented-tree
writes only the generated targets below. The CLI validates each file hash before writing and
prompts before replacing local changes unless --force is used.
- Version
- 1.1.0
- License
- open
- Stability
- stable
- Contract
- v2
- Foundation
- ≥ 1.0.0
| Type | Generated target |
|---|---|
| blade | resources/views/components/ui/indented-tree.blade.php |
Registry dependencies
None.
Package dependencies
composer: jml/brok:^1.0
Guidance
Diagram and relationship viewExplain hierarchy, causality, network structure, or flow.
Use when
- Use when hierarchy, causality, network structure, or process flow is the information itself. Do not use specialized diagrams when a list, table, or short paragraph would be easier to interpret.
Avoid when
- Avoid using indented-tree as a default simply because it is available in the library. Choose it only when its interaction cost, visibility, and behavior match the job to be done.
- Task length
- medium
- Interaction cost
- high
- Interruptiveness
- none
- Input precision
- none
- Mobile / touch risk
- high
- Accessibility risk
- high
- Needs background context
- No
- Comparison needed
- Yes
Preferred alternatives
- List, table, or prose explanation
Anti-patterns
- Using a specialized diagram when linear content is clearer
API
manifest knowledge + registry-derived coverageProps
| Prop | Type / values | Default | Description |
|---|---|---|---|
| items | mixed|null | null | Declared by @props in the registry Blade source. |
| label | string | Indented tree | Declared by @props in the registry Blade source. |
| variant | string | default | Declared by @props in the registry Blade source. |
| name | string | permissions | Declared by @props in the registry Blade source. |
Slots
default— Primary Blade slot rendered by the component.
Data slots
indented-tree
indented-tree-row
Capabilities
Behavior
- Uses server-rendered Blade and semantic HTML.
- Declares registry capability flags: a11y, responsive, rtl, darkMode, localized.
Usage
<div class="space-y-4">
<x-ui.indented-tree class="max-w-md" />
<p class="text-sm text-muted-foreground">
{{ __('A static, dependency-free nested outline. Pass `:items` — an array of nodes with a `label`, an optional `meta` (e.g. a count or size) and an optional `children[]` array — and it flattens depth-first into indented rows with guide lines.') }}
</p>
</div>
Accessibility & localization
data-slot
Keyboard focus-visible
Localized labels
- Accessibility target: wcag-2.2-aa-target.
- Uses semantic HTML and a stable
data-slotattribute for styling/scripting hooks. - Focus-visible rings use the
ringtoken so keyboard focus is always visible. - Disabled and invalid states are conveyed to assistive tech, not by color alone.
- Targets WCAG 2.2 AA; verify contrast in light, dark, admin and customer surfaces above.
- Labels go through
__()and the component uses logical properties (ms-*,text-start,start-*) so it mirrors correctly — flip the preview to RTL to confirm.
Source
The exact, editable file ui:add writes
into your app — copy it or own the whole thing. Previews
render this same code; there are no preview-only components.
Changelog
Current version: v1.1.0. See the site changelog for the full release history.