Empty State
Placeholder component for displaying when no data exists
The Empty State component is used to display a helpful message when there's no data to show. It combines an illustration, title, description, and an optional call-to-action button.
Preview
Usage
<x-shopper::empty-state
title="No products yet"
content="Get started by creating your first product."
button="Create Product"
permission="add_products"
panel="{ component: 'shopper-slide-overs.add-product' }"
>
<img src="{{ asset('images/empty-products.svg') }}" alt="" class="h-auto w-full max-w-xs" />
</x-shopper::empty-state>Props
| Prop | Default | Description |
|---|---|---|
x-shopper::empty-staterenders a <div> element | ||
titlestring | required | The main heading text for the empty state. |
contentstring | required | Descriptive text explaining the empty state and what action can be taken. |
buttonstring | false | false | Text for the call-to-action button. The button only shows when |
permissionstring | false | false | Permission name required to show the button. Uses Laravel's |
urlstring | false | false | URL for the button link. Use this for navigation to a create page. |
panelstring | null | null | Arguments of the |
Examples
Basic Empty State
<x-shopper::empty-state
title="No orders found"
content="When customers place orders, they will appear here."
>
<img src="{{ asset('images/empty-orders.svg') }}" alt="" />
</x-shopper::empty-state>With URL Action
<x-shopper::empty-state
title="No customers"
content="Customers will appear here once they create an account or place an order."
button="Add Customer"
permission="add_customers"
:url="route('shopper.customers.create')"
>
<img src="{{ asset('images/empty-customers.svg') }}" alt="" />
</x-shopper::empty-state>With Panel Action
Use a panel action to open a slide-over instead of navigating:
<x-shopper::empty-state
title="No attributes"
content="Attributes let you define extra product characteristics like color or size."
button="Create Attribute"
permission="add_attributes"
panel="{ component: 'shopper-slide-overs.attribute-form' }"
>
<img src="{{ asset('images/empty-attributes.svg') }}" alt="" />
</x-shopper::empty-state>Without Button
When you don't want to show an action button:
<x-shopper::empty-state
title="No reviews yet"
content="Reviews will appear here once customers start leaving feedback."
>
<img src="{{ asset('images/empty-reviews.svg') }}" alt="" />
</x-shopper::empty-state>Custom Slot Content
The default slot is used for the illustration on the left side:
<x-shopper::empty-state
title="No discounts"
content="Create discount codes to offer promotions to your customers."
button="Create Discount"
permission="add_discounts"
panel="{ component: 'shopper-slide-overs.discount-form' }"
>
{{-- Custom SVG or image --}}
<svg class="h-40 w-40 text-gray-400" ...>
<!-- Your custom illustration -->
</svg>
</x-shopper::empty-state>Usage in Livewire Components
Empty states are typically rendered conditionally when a collection is empty:
@if ($products->isEmpty())
<x-shopper::empty-state
title="No products"
content="Start building your catalog by adding your first product."
button="Add Product"
permission="add_products"
panel="{ component: 'shopper-slide-overs.add-product' }"
>
<img src="{{ asset('images/empty-products.svg') }}" alt="" />
</x-shopper::empty-state>
@else
{{-- Product list/table --}}
@endifBlade Component Source
The Empty State component is located at packages/admin/resources/views/components/empty-state.blade.php:
@props([
'title',
'content',
'button' => false,
'permission' => false,
'url' => false,
'panel' => null,
])
<div
{{ $attributes->twMerge(['class' => 'relative w-full lg:flex lg:items-center py-8 lg:py-12']) }}
>
<div class="relative flex w-full justify-center lg:block lg:w-1/2">
{{ $slot }}
</div>
<div class="relative mt-10 flex w-full items-center justify-center lg:mt-0 lg:w-1/2 lg:py-20">
<div class="w-full text-center sm:max-w-md lg:text-left">
<h3
class="font-heading text-lg font-medium text-gray-900 sm:text-lg sm:leading-7 lg:text-2xl dark:text-white"
>
{{ $title }}
</h3>
<p class="mt-4 text-base text-gray-500 dark:text-gray-400">
{{ $content }}
</p>
@if ($permission)
@can($permission)
@if ($url)
<x-filament::button tag="a" :href="$url" wire:navigate class="mt-5">
{{ $button }}
</x-filament::button>
@elseif ($panel)
<x-filament::button
type="button"
wire:click="$dispatch('openPanel', {{ $panel }})"
class="mt-5"
>
{{ $button }}
</x-filament::button>
@endif
@endcan
@endif
</div>
</div>
</div>Last updated on
Edit on GitHub