Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 1m14s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 1m12s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 1m7s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 1m19s
CI / PHP 8.3 / mysql:8.0 (pull_request) Successful in 1m32s
CI / PHP 8.4 / mysql:8.0 (pull_request) Successful in 1m22s
CI / PHP 8.4 / mysql:8.4 (pull_request) Successful in 1m32s
CI / PHP 8.3 / mysql:8.4 (pull_request) Successful in 1m35s
CI / Build-Artefakte aktuell (pull_request) Failing after 1m7s
- Laravel 13 mit Filament 5 (Admin), Inertia 3 + Vue 3 + Vuetify 4 (Material 3) - Anmeldung über Fortify (Login, Passwort vergessen/ändern), keine Selbstregistrierung - Profil mit Profilbild (WebP in festen Größen), Personenseiten, Header mit Avatar-Menü - Material-3-Farbschema aus der Primärfarbe, hell/dunkel/System pro Person - Basis-Branding (Portalname, Logo, Primärfarbe) im Admin unter „Erscheinungsbild“ - Benutzerverwaltung im Admin, Zugang vorläufig über is_admin - vendor/ (ohne Dev-Pakete) und Frontend-Build mitversioniert, Dev-Pakete in vendor-dev/ - PHPUnit-Tests gegen MySQL/MariaDB, Forgejo-CI-Matrix, Docker-Entwicklungsumgebung - VERSION, CHANGELOG.md und CONTRIBUTING.md mit Release-Ablauf Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
95 lines
2.4 KiB
Markdown
95 lines
2.4 KiB
Markdown
---
|
|
title: Empty state
|
|
---
|
|
import AutoScreenshot from "@components/AutoScreenshot.astro"
|
|
|
|
## Introduction
|
|
|
|
The table's "empty state" is rendered when there are no rows in the table.
|
|
|
|
<AutoScreenshot name="tables/empty-state" alt="Table with empty state" version="5.x" />
|
|
|
|
## Setting the empty state heading
|
|
|
|
To customize the heading of the empty state, use the `emptyStateHeading()` method:
|
|
|
|
```php
|
|
use Filament\Tables\Table;
|
|
|
|
public function table(Table $table): Table
|
|
{
|
|
return $table
|
|
->emptyStateHeading('No posts yet');
|
|
}
|
|
```
|
|
|
|
<AutoScreenshot name="tables/empty-state-heading" alt="Table with customized empty state heading" version="5.x" />
|
|
|
|
## Setting the empty state description
|
|
|
|
To customize the description of the empty state, use the `emptyStateDescription()` method:
|
|
|
|
```php
|
|
use Filament\Tables\Table;
|
|
|
|
public function table(Table $table): Table
|
|
{
|
|
return $table
|
|
->emptyStateDescription('Once you write your first post, it will appear here.');
|
|
}
|
|
```
|
|
|
|
<AutoScreenshot name="tables/empty-state-description" alt="Table with empty state description" version="5.x" />
|
|
|
|
## Setting the empty state icon
|
|
|
|
To customize the [icon](../styling/icons) of the empty state, use the `emptyStateIcon()` method:
|
|
|
|
```php
|
|
use Filament\Tables\Table;
|
|
|
|
public function table(Table $table): Table
|
|
{
|
|
return $table
|
|
->emptyStateIcon('heroicon-o-bookmark');
|
|
}
|
|
```
|
|
|
|
<AutoScreenshot name="tables/empty-state-icon" alt="Table with customized empty state icon" version="5.x" />
|
|
|
|
## Adding empty state actions
|
|
|
|
You can add [Actions](actions) to the empty state to prompt users to take action. Pass these to the `emptyStateActions()` method:
|
|
|
|
```php
|
|
use Filament\Actions\Action;
|
|
use Filament\Tables\Table;
|
|
|
|
public function table(Table $table): Table
|
|
{
|
|
return $table
|
|
->emptyStateActions([
|
|
Action::make('create')
|
|
->label('Create post')
|
|
->url(route('posts.create'))
|
|
->icon('heroicon-m-plus')
|
|
->button(),
|
|
]);
|
|
}
|
|
```
|
|
|
|
<AutoScreenshot name="tables/empty-state-actions" alt="Table with empty state actions" version="5.x" />
|
|
|
|
## Using a custom empty state view
|
|
|
|
You may use a completely custom empty state view by passing it to the `emptyState()` method:
|
|
|
|
```php
|
|
use Filament\Tables\Table;
|
|
|
|
public function table(Table $table): Table
|
|
{
|
|
return $table
|
|
->emptyState(view('tables.posts.empty-state'));
|
|
}
|
|
```
|