公告: 旧版文档请移步 -> http://v2.laravel-filament.cn/docs

Languages

Version

Theme

Infolist Builder

Actions

Overview

Filament's infolists can use Actions. They are buttons that can be added to any infolist component. Also, you can render anonymous sets of actions on their own, that are not attached to a particular infolist component.

Defining a infolist component action

Action objects inside an infolist component are instances of Filament/Infolists/Components/Actions/Action. You must pass a unique name to the action's make() method, which is used to identify it amongst others internally within Filament. You can customize the trigger button of an action, and even open a modal with little effort:

use App\Actions\ResetStars;
use Filament\Infolists\Components\Actions\Action;
 
Action::make('resetStars')
->icon('heroicon-m-x-mark')
->color('danger')
->requiresConfirmation()
->action(function (ResetStars $resetStars) {
$resetStars();
})

Adding an affix action to a entry

Certain entries support "affix actions", which are buttons that can be placed before or after its content. The following entries support affix actions:

To define an affix action, you can pass it to either prefixAction() or suffixAction():

use App\Models\Product;
use Filament\Infolists\Components\Actions\Action;
use Filament\Infolists\Components\TextEntry;
 
TextEntry::make('cost')
->prefix('')
->suffixAction(
Action::make('copyCostToPrice')
->icon('heroicon-m-clipboard')
->requiresConfirmation()
->action(function (Product $record) {
$record->price = $record->cost;
$record->save();
})
)
Text entry with suffix action

Passing multiple affix actions to a entry

You may pass multiple affix actions to an entry by passing them in an array to either prefixActions() or suffixActions(). Either method can be used, or both at once, Filament will render all the registered actions in order:

use Filament\Infolists\Components\Actions\Action;
use Filament\Infolists\Components\TextEntry;
 
TextEntry::make('cost')
->prefix('')
->prefixActions([
Action::make('...'),
Action::make('...'),
Action::make('...'),
])
->suffixActions([
Action::make('...'),
Action::make('...'),
])

Adding a hint action to an entry

All entries support "hint actions", which are rendered aside the entry's hint. To add a hint action to a entry, you may pass it to hintAction():

use App\Models\Product;
use Filament\Infolists\Components\Actions\Action;
use Filament\Infolists\Components\TextEntry;
 
TextEntry::make('cost')
->prefix('')
->hintAction(
Action::make('copyCostToPrice')
->icon('heroicon-m-clipboard')
->requiresConfirmation()
->action(function (Product $record) {
$record->price = $record->cost;
$record->save();
})
)
Text entry with hint action

Passing multiple hint actions to a entry

You may pass multiple hint actions to a entry by passing them in an array to hintActions(). Filament will render all the registered actions in order:

use Filament\Infolists\Components\Actions\Action;
use Filament\Infolists\Components\TextEntry;
 
TextEntry::make('cost')
->prefix('')
->hintActions([
Action::make('...'),
Action::make('...'),
Action::make('...'),
])

Adding an action to a custom infolist component

If you wish to render an action within a custom infolist component, ViewEntry object, or View component object, you may do so using the registerActions() method:

use App\Models\Post;
use Filament\Forms\Components\TextInput;
use Filament\Infolists\Components\Actions\Action;
use Filament\Infolists\Components\ViewEntry;
use Filament\Infolists\Set;
 
ViewEntry::make('status')
->view('filament.infolists.entries.status-switcher')
->registerActions([
Action::make('createStatus')
->form([
TextInput::make('name')
->required(),
])
->icon('heroicon-m-plus')
->action(function (array $data, Post $record) {
$record->status()->create($data);
}),
])

Now, to render the action in the view of the custom component, you need to call $getAction(), passing the name of the action you registered:

<div>
<select></select>
{{ $getAction('createStatus') }}
</div>

Adding "anonymous" actions to an infolist without attaching them to a component

You may use an Actions component to render a set of actions anywhere in the infolist, avoiding the need to register them to any particular component:

use App\Actions\Star;
use App\Actions\ResetStars;
use Filament\Infolists\Components\Actions;
use Filament\Infolists\Components\Actions\Action;
 
Actions::make([
Action::make('star')
->icon('heroicon-m-star')
->requiresConfirmation()
->action(function (Star $star) {
$star();
}),
Action::make('resetStars')
->icon('heroicon-m-x-mark')
->color('danger')
->requiresConfirmation()
->action(function (ResetStars $resetStars) {
$resetStars();
}),
]),
Anonymous actions

Making the independent infolist actions consume the full width of the infolist

You can stretch the independent infolist actions to consume the full width of the infolist using fullWidth():

use Filament\Infolists\Components\Actions;
 
Actions::make([
// ...
])->fullWidth(),
Anonymous actions consuming the full width

Controlling the horizontal alignment of independent infolist actions

Independent infolist actions are aligned to the start of the component by default. You may change this by passing Alignment::Center or Alignment::End to alignment():

use Filament\Infolists\Components\Actions;
use Filament\Support\Enums\Alignment;
 
Actions::make([
// ...
])->alignment(Alignment::Center),
Anonymous actions horizontally aligned to the center

Controlling the vertical alignment of independent infolist actions

Independent infolist actions are vertically aligned to the start of the component by default. You may change this by passing Alignment::Center or Alignment::End to verticalAlignment():

use Filament\Infolists\Components\Actions;
use Filament\Support\Enums\VerticalAlignment;
 
Actions::make([
// ...
])->verticalAlignment(VerticalAlignment::End),
Anonymous actions vertically aligned to the end
Edit on GitHub

Still need help? Join our Discord community or open a GitHub discussion