EmptyState

Zero-data placeholders shown when a list or view has no content yet. Supports link actions, JS click handlers, FAB triggers, and a compact variant for inline panels.

Default Variant

No tasks yet

Get started by adding your first task. Your tasks will appear here.

Add your first task

JS Click Handler

No data loaded

Click below to fetch data from the server.

Compact Variant (for Panels)

No items scheduled

No activity tracked

// Default with link action
<?= $m->emptyState('id')
    ->icon('fa-clipboard-list')
    ->title('No tasks yet')
    ->message('Add your first task to get started.')
    ->action('Add Task', '/tasks/create', 'fa-plus') ?>

// JS click handler
<?= $m->emptyState('id2')
    ->icon('fa-sync')
    ->title('No data loaded')
    ->actionJs('Load Data', 'fetchData()', 'fa-download') ?>

// Compact with border
<?= $m->emptyState('id3')
    ->compact()
    ->bordered()
    ->icon('fa-inbox')
    ->title('No items scheduled')
    ->actionFab('Add Task', 'task', 'fa-plus') ?>

PHP PHP Methods (Fluent)

Method / Property	Parameters	Description
`$m->emptyState($id)`	`string`	Create an empty state component.
`->icon($faIcon)`	`string`	Set the large icon displayed above the title.
`->title($title)`	`string`	Set the heading text.
`->message($message)`	`string`	Set the descriptive message text.
`->action($label, $url, $icon)`	`string, string, ?string`	Add a link-style call-to-action button.
`->actionJs($label, $onClick, $icon)`	`string, string, ?string`	Add a button with an `onclick` JS handler.
`->actionFab($label, $fabAction, $icon)`	`string, string, ?string`	Add a FAB-trigger button.
`->compact()`		Use reduced padding for inline/panel usage.
`->bordered()`		Add a dashed border and background tint.