> ## Documentation Index
> Fetch the complete documentation index at: https://filamentphp.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Adding an action to a Livewire component
export const EditOnGitHub = ({version, path}) => {
const url = `https://github.com/filamentphp/filament/edit/${version}/${path}`;
return
;
};
You are currently viewing the documentation for Filament 3.x, which is a previous version of Filament.
Looking for the current stable version? Visit the [5.x documentation](/docs/5.x/actions).
## Setting up the Livewire component
First, generate a new Livewire component:
```bash theme={"theme":"gruvbox-dark-hard"}
php artisan make:livewire ManageProduct
```
Then, render your Livewire component on the page:
```blade theme={"theme":"gruvbox-dark-hard"}
@livewire('manage-product')
```
Alternatively, you can use a full-page Livewire component:
```php theme={"theme":"gruvbox-dark-hard"}
use App\Livewire\ManageProduct;
use Illuminate\Support\Facades\Route;
Route::get('products/{product}/manage', ManageProduct::class);
```
You must use the `InteractsWithActions` and `InteractsWithForms` traits, and implement the `HasActions` and `HasForms` interfaces on your Livewire component class:
```php theme={"theme":"gruvbox-dark-hard"}
use Filament\Actions\Concerns\InteractsWithActions;
use Filament\Actions\Contracts\HasActions;
use Filament\Forms\Concerns\InteractsWithForms;
use Filament\Forms\Contracts\HasForms;
use Livewire\Component;
class ManagePost extends Component implements HasForms, HasActions
{
use InteractsWithActions;
use InteractsWithForms;
// ...
}
```
## Adding the action
Add a method that returns your action. The method must share the exact same name as the action, or the name followed by `Action`:
```php theme={"theme":"gruvbox-dark-hard"}
use App\Models\Post;
use Filament\Actions\Action;
use Filament\Actions\Concerns\InteractsWithActions;
use Filament\Actions\Contracts\HasActions;
use Filament\Forms\Concerns\InteractsWithForms;
use Filament\Forms\Contracts\HasForms;
use Livewire\Component;
class ManagePost extends Component implements HasForms, HasActions
{
use InteractsWithActions;
use InteractsWithForms;
public Post $post;
public function deleteAction(): Action
{
return Action::make('delete')
->requiresConfirmation()
->action(fn () => $this->post->delete());
}
// This method name also works, since the action name is `delete`:
// public function delete(): Action
// This method name does not work, since the action name is `delete`, not `deletePost`:
// public function deletePost(): Action
// ...
}
```
Finally, you need to render the action in your view. To do this, you can use `{{ $this->deleteAction }}`, where you replace `deleteAction` with the name of your action method:
```blade theme={"theme":"gruvbox-dark-hard"}
{{ $this->deleteAction }}
```
You also need `` which injects the HTML required to render action modals. This only needs to be included within the Livewire component once, regardless of how many actions you have for that component.
## Passing action arguments
Sometimes, you may wish to pass arguments to your action. For example, if you're rendering the same action multiple times in the same view, but each time for a different model, you could pass the model ID as an argument, and then retrieve it later. To do this, you can invoke the action in your view and pass in the arguments as an array:
```php theme={"theme":"gruvbox-dark-hard"}
```
Now, you can access the post ID in your action method:
```php theme={"theme":"gruvbox-dark-hard"}
use App\Models\Post;
use Filament\Actions\Action;
public function deleteAction(): Action
{
return Action::make('delete')
->requiresConfirmation()
->action(function (array $arguments) {
$post = Post::find($arguments['post']);
$post?->delete();
});
}
```
## Hiding actions in a Livewire view
If you use `hidden()` or `visible()` to control if an action is rendered, you should wrap the action in an `@if` check for `isVisible()`:
```blade theme={"theme":"gruvbox-dark-hard"}
```
The `hidden()` and `visible()` methods also control if the action is `disabled()`, so they are still useful to protect the action from being run if the user does not have permission. Encapsulating this logic in the `hidden()` or `visible()` of the action itself is good practice otherwise you need to define the condition in the view and in `disabled()`.
You can also take advantage of this to hide any wrapping elements that may not need to be rendered if the action is hidden:
```blade theme={"theme":"gruvbox-dark-hard"}
@if ($this->deleteAction->isVisible())
{{ $this->deleteAction }}
@endif
```
## Grouping actions in a Livewire view
You may [group actions together into a dropdown menu](./grouping-actions) by using the `` Blade component, passing in the `actions` array as an attribute:
```blade theme={"theme":"gruvbox-dark-hard"}
```
You can also pass in any attributes to customize the appearance of the trigger button and dropdown:
```blade theme={"theme":"gruvbox-dark-hard"}
```
## Chaining actions
You can chain multiple actions together, by calling the `replaceMountedAction()` method to replace the current action with another when it has finished:
```php theme={"theme":"gruvbox-dark-hard"}
use App\Models\Post;
use Filament\Actions\Action;
public function editAction(): Action
{
return Action::make('edit')
->form([
// ...
])
// ...
->action(function (array $arguments) {
$post = Post::find($arguments['post']);
// ...
$this->replaceMountedAction('publish', $arguments);
});
}
public function publishAction(): Action
{
return Action::make('publish')
->requiresConfirmation()
// ...
->action(function (array $arguments) {
$post = Post::find($arguments['post']);
$post->publish();
});
}
```
Now, when the first action is submitted, the second action will open in its place. The [arguments](#passing-action-arguments) that were originally passed to the first action get passed to the second action, so you can use them to persist data between requests.
If the first action is canceled, the second one is not opened. If the second action is canceled, the first one has already run and cannot be cancelled.
## Programmatically triggering actions
Sometimes you may need to trigger an action without the user clicking on the built-in trigger button, especially from JavaScript. Here is an example action which could be registered on a Livewire component:
```php theme={"theme":"gruvbox-dark-hard"}
use Filament\Actions\Action;
public function testAction(): Action
{
return Action::make('test')
->requiresConfirmation()
->action(function (array $arguments) {
dd('Test action called', $arguments);
});
}
```
You can trigger that action from a click in your HTML using the `wire:click` attribute, calling the `mountAction()` method and optionally passing in any arguments that you want to be available:
```blade theme={"theme":"gruvbox-dark-hard"}
```
To trigger that action from JavaScript, you can use the [`$wire` utility](https://livewire.laravel.com/docs/alpine#controlling-livewire-from-alpine-using-wire), passing in the same arguments:
```js theme={"theme":"gruvbox-dark-hard"}
$wire.mountAction('test', { id: 12345 })
```
)}
Your logo here