License Key Required

No license key entered. Enter or update your key with php artisan realestate:license <key>, or purchase one at scriptgain.com.

Folder Tree

components.admin.folder-tree

All Templates

Status Shipped Default Shipped File resources/views/components/admin/folder-tree.blade.php

components.admin.folder-tree 41 lines

Not Checked Yet

@props(['tree' => [], 'active' => null, 'rootLabel' => 'All Files', 'rootHref' => null])
{{-- Keyboard-operable folder tree.

     Real links inside role="tree"/"treeitem" so it works with Tab and with a
     screen reader out of the box; public/js/realestate.js adds arrow-key
     roving focus on top (see the mm-folder-tree handler). Indentation comes
     from a precomputed `indent` value so this template stays markup only. --}}
<nav aria-label="Folders" class="mm-folder-tree" role="tree">
    <a href="{{ $rootHref }}" role="treeitem" aria-level="1"
       @if (! $active) aria-current="page" @endif
       @class([
           'group flex items-center gap-2 rounded-lg px-2.5 py-2 text-sm transition focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-500',
           'bg-brand-50 font-semibold text-brand-800' => ! $active,
           'text-slate-700 hover:bg-slate-100' => (bool) $active,
       ])>
        <x-icon name="archive" class="w-4 h-4 shrink-0 text-slate-400" />
        <span class="truncate">{{ $rootLabel }}</span>
    </a>

    @foreach ($tree as $node)
        <a href="{{ route('files.index', ['folder' => $node['folder']->slug]) }}"
           role="treeitem" aria-level="{{ $node['depth'] + 2 }}"
           style="padding-left: {{ $node['indent'] }}px"
           @if ($active === $node['folder']->slug) aria-current="page" @endif
           @class([
               'group flex items-center gap-2 rounded-lg py-2 pr-2.5 text-sm transition focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-500',
               'bg-brand-50 font-semibold text-brand-800' => $active === $node['folder']->slug,
               'text-slate-700 hover:bg-slate-100' => $active !== $node['folder']->slug,
           ])>
            <x-icon :name="$node['folder']->icon ?: 'folder'" class="w-4 h-4 shrink-0 text-slate-400 ml-2.5" />
            <span class="truncate">{{ $node['folder']->name }}</span>
            @unless ($node['folder']->is_public)
                <span class="ml-auto shrink-0" data-tip="Staff Only. This folder is hidden from the public file browser.">
                    <x-icon name="lock" class="w-3.5 h-3.5 text-amber-500" />
                    <span class="sr-only">Staff Only</span>
                </span>
            @endunless
        </a>
    @endforeach
</nav>

Change Note

Optional. Shown in the version history so the next person knows why.

Saving runs the same check. An invalid template is refused, not stored.

Compiled PHP

What Blade turns your template into. This is what the syntax check parses.

Loading…

Available Variables And Components

A guide to what this template can use, derived from the shipped source. Click any item to insert it at your cursor. It is a helpful reference, not a runtime guarantee.

Always Available

Shared with the admin panel by the staff layout.

Validation error bag. Always present. Pairs with @error('field').

The admin sidebar navigation structure.

Sub-items of the currently open nav group.

Breadcrumb trail for the current page.

Signed-in staffer's initials, for the avatar.

Signed-in staffer's name.

Signed-in staffer's email address.

The staffer's role, e.g. "Administrator".

True when the signed-in staffer is an administrator.

Number of open service requests, for the badge.

Number of unread form submissions, for the badge.

The configured admin-shell width class.

URL of the uploaded site logo, or null.

URL of the uploaded favicon, or null.

In This Template

Active.

Root Href.

Root Label.

Tree.

Drop any of these in. Click to insert the opening tag at your cursor.

General

type, info, title

initials, src, name, size, md

color, neutral, dot

action, label, Record, modal

variant, primary, size, md, href, …

title, subtitle, padding, flush

name, action, method, POST, title, …

action, name, title, message, confirm, …

href, icon, danger

align, right, width

icon, folder, title, description

label, for, hint, error, required

href, icon, title, variant, secondary, …

name

type, text

name, title, subtitle, icon, tone, …

href, icon, active

title, subtitle, icon, back

title, subtitle, href, linkLabel

ids

id, label, Row

items

label, value, icon, trend, trendColor, …

color, neutral, pulse, label

name

flush

tabs, default

name, checked, label, description

Admin Panel

title, message, icon, folder, href, …

tree, active, rootLabel, rootHref

title, subtitle, icon, edit, action, …

title, icon, folder, subtitle, records, …

search, placeholder, createHref, createLabel

edit, delete, preview, name, title, …

record, kind, Page

Layouts

title, shellMaxWidth

title, description, heroless, maxWidth

Records

name, action, reference, trigger, icon

Site (Public)

href, title, description, icon, meta, …

title, message, icon, folder

title, subtitle, eyebrow, icon, crumbs, …

supportEmail, supportPhone

disclaimer, takedownContact, retentionDays, compact

title, subtitle, href, linkLabel, tone, …

maxWidth

Common Blade

Print a value, safely escaped. The default choice.

Print raw HTML. Only for content you trust.

Show something conditionally.

Loop over a collection.

Loop, with a fallback when the collection is empty.

Show a validation message for a field.

A small block of PHP. Never on line 1. Keep logic out of templates.

A comment that never reaches the browser.

Civic Helpers

Build a URL to a named route, e.g. a department page.

Link to a single news post.

Turn a stored upload path into a public URL.

A cache-busted URL for a bundled asset.

Read a config value, e.g. the site width class.

Build an absolute URL to a path.

No History Yet

Every save, revert, and reset of this template is recorded here, with a one-click way back to any of them.

The Template That Shipped With The Product

Read only. This is what Reset To Default puts back.

@props(['tree' => [], 'active' => null, 'rootLabel' => 'All Files', 'rootHref' => null])
{{-- Keyboard-operable folder tree.

     Real links inside role="tree"/"treeitem" so it works with Tab and with a
     screen reader out of the box; public/js/realestate.js adds arrow-key
     roving focus on top (see the mm-folder-tree handler). Indentation comes
     from a precomputed `indent` value so this template stays markup only. --}}
<nav aria-label="Folders" class="mm-folder-tree" role="tree">
    <a href="{{ $rootHref }}" role="treeitem" aria-level="1"
       @if (! $active) aria-current="page" @endif
       @class([
           'group flex items-center gap-2 rounded-lg px-2.5 py-2 text-sm transition focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-500',
           'bg-brand-50 font-semibold text-brand-800' => ! $active,
           'text-slate-700 hover:bg-slate-100' => (bool) $active,
       ])>
        <x-icon name="archive" class="w-4 h-4 shrink-0 text-slate-400" />
        <span class="truncate">{{ $rootLabel }}</span>
    </a>

    @foreach ($tree as $node)
        <a href="{{ route('files.index', ['folder' => $node['folder']->slug]) }}"
           role="treeitem" aria-level="{{ $node['depth'] + 2 }}"
           style="padding-left: {{ $node['indent'] }}px"
           @if ($active === $node['folder']->slug) aria-current="page" @endif
           @class([
               'group flex items-center gap-2 rounded-lg py-2 pr-2.5 text-sm transition focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-brand-500',
               'bg-brand-50 font-semibold text-brand-800' => $active === $node['folder']->slug,
               'text-slate-700 hover:bg-slate-100' => $active !== $node['folder']->slug,
           ])>
            <x-icon :name="$node['folder']->icon ?: 'folder'" class="w-4 h-4 shrink-0 text-slate-400 ml-2.5" />
            <span class="truncate">{{ $node['folder']->name }}</span>
            @unless ($node['folder']->is_public)
                <span class="ml-auto shrink-0" data-tip="Staff Only. This folder is hidden from the public file browser.">
                    <x-icon name="lock" class="w-3.5 h-3.5 text-amber-500" />
                    <span class="sr-only">Staff Only</span>
                </span>
            @endunless
        </a>
    @endforeach
</nav>

Blade In One Screen

The directives you will use most.

{{ $variable }}

Print a value, escaped. Safe by default.

{!! $html !!}

Print raw HTML. Only for content you trust.

@if / @else / @endif

Show something conditionally.

@foreach / @endforeach

Loop over a collection.

<x-card>

Use a shared component. Every component in Shared Components is available.

{{-- comment --}}

A comment that never reaches the browser.

House Rules

Follow these and your edits will survive updates.

Never start line 1 with @php. Blade mis-parses it and the page fails. The editor refuses to save it.
Keep logic out of templates. If you need a calculation, it belongs in a composer or component class, not here.
The shipped file is never modified. Reset To Default always gets you back.
Every save is versioned. You can revert to any earlier version in one click.
Press Tab inside the editor to indent rather than jump to the next field.