License Key Required

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

Icon Button

components.icon-button

All Templates

Status Shipped Default Shipped File resources/views/components/icon-button.blade.php

components.icon-button 37 lines

Not Checked Yet

@props(['href' => null, 'icon', 'title' => null, 'variant' => 'secondary', 'type' => 'button'])
@php
    $variants = [
        'secondary' => 'bg-white ring-1 ring-inset ring-slate-300 text-slate-600 hover:bg-slate-50 hover:text-slate-900',
        'ghost' => 'text-slate-500 hover:bg-slate-100 hover:text-slate-900',
        'danger' => 'bg-white ring-1 ring-inset ring-rose-200 text-rose-600 hover:bg-rose-50 hover:ring-rose-300',
        'brand' => 'bg-brand-50 ring-1 ring-inset ring-brand-200 text-brand-700 hover:bg-brand-100',
    ];
    $classes = 'inline-flex items-center justify-center w-9 h-9 rounded-lg transition ' . ($variants[$variant] ?? $variants['secondary']);
@endphp
{{-- Styled tooltip teleported to <body> with fixed positioning, so it's fully
     outside any table's overflow-x-auto and can never expand horizontal scroll. --}}
<span class="inline-flex"
    @if ($title)
        x-data="{ tip: false, tx: 0, ty: 0 }"
        @mouseenter="const r = $el.getBoundingClientRect(); tx = r.left + r.width / 2; ty = r.top - 8; tip = true"
        @mouseleave="tip = false"
    @endif>
    @if ($href)
        <a href="{{ $href }}" @if ($title) aria-label="{{ $title }}" @endif {{ $attributes->merge(['class' => $classes]) }}>
            <x-icon :name="$icon" class="w-4 h-4" />
        </a>
    @else
        <button type="{{ $type }}" @if ($title) aria-label="{{ $title }}" @endif {{ $attributes->merge(['class' => $classes]) }}>
            <x-icon :name="$icon" class="w-4 h-4" />
        </button>
    @endif
    @if ($title)
        <template x-teleport="body">
            <div x-show="tip" x-cloak :style="`left:${tx}px;top:${ty}px`"
                class="fixed -translate-x-1/2 -translate-y-full pointer-events-none z-[100] whitespace-nowrap rounded-md bg-slate-900 px-2 py-1 text-xs font-medium text-white shadow-lg">
                {{ $title }}
            </div>
        </template>
    @endif
</span>

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

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

In This Template

El.

Href.

Icon.

The page title set by the controller.

Type.

Variant.

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(['href' => null, 'icon', 'title' => null, 'variant' => 'secondary', 'type' => 'button'])
@php
    $variants = [
        'secondary' => 'bg-white ring-1 ring-inset ring-slate-300 text-slate-600 hover:bg-slate-50 hover:text-slate-900',
        'ghost' => 'text-slate-500 hover:bg-slate-100 hover:text-slate-900',
        'danger' => 'bg-white ring-1 ring-inset ring-rose-200 text-rose-600 hover:bg-rose-50 hover:ring-rose-300',
        'brand' => 'bg-brand-50 ring-1 ring-inset ring-brand-200 text-brand-700 hover:bg-brand-100',
    ];
    $classes = 'inline-flex items-center justify-center w-9 h-9 rounded-lg transition ' . ($variants[$variant] ?? $variants['secondary']);
@endphp
{{-- Styled tooltip teleported to <body> with fixed positioning, so it's fully
     outside any table's overflow-x-auto and can never expand horizontal scroll. --}}
<span class="inline-flex"
    @if ($title)
        x-data="{ tip: false, tx: 0, ty: 0 }"
        @mouseenter="const r = $el.getBoundingClientRect(); tx = r.left + r.width / 2; ty = r.top - 8; tip = true"
        @mouseleave="tip = false"
    @endif>
    @if ($href)
        <a href="{{ $href }}" @if ($title) aria-label="{{ $title }}" @endif {{ $attributes->merge(['class' => $classes]) }}>
            <x-icon :name="$icon" class="w-4 h-4" />
        </a>
    @else
        <button type="{{ $type }}" @if ($title) aria-label="{{ $title }}" @endif {{ $attributes->merge(['class' => $classes]) }}>
            <x-icon :name="$icon" class="w-4 h-4" />
        </button>
    @endif
    @if ($title)
        <template x-teleport="body">
            <div x-show="tip" x-cloak :style="`left:${tx}px;top:${ty}px`"
                class="fixed -translate-x-1/2 -translate-y-full pointer-events-none z-[100] whitespace-nowrap rounded-md bg-slate-900 px-2 py-1 text-xs font-medium text-white shadow-lg">
                {{ $title }}
            </div>
        </template>
    @endif
</span>

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.