Skip to main content
Version: Next

View action

Introduction

Filament includes an action that is able to view Eloquent records. When the trigger button is clicked, a modal will open with information inside. Filament uses form fields to structure this information. All form fields are disabled, so they are not editable by the user. You may use it like so:

use Filament\Actions\ViewAction;
use Filament\Forms\Components\TextInput;

ViewAction::make()
->schema([
TextInput::make('title')
->required()
->maxLength(255),
// ...
])

Customizing data before filling the form

You may wish to modify the data from a record before it is filled into the form. To do this, you may use the mutateRecordDataUsing() method to modify the $data array, and return the modified version before it is filled into the form:

use Filament\Actions\ViewAction;

ViewAction::make()
->mutateRecordDataUsing(function (array $data): array {
$data['user_id'] = auth()->id();

return $data;
})
As well as $data, the mutateRecordDataUsing() function can inject various utilities as parameters.Learn more about utility injection.
UtilityTypeParameterDescription
ActionFilament\Actions\Action$actionThe current action instance.
Argumentsarray<string, mixed>$argumentsThe array of arguments passed to the action when it was triggered.
Dataarray<string, mixed>$dataThe array of data submitted from form fields in the action's modal. It will be empty before the modal form is submitted.
LivewireLivewire\Component$livewireThe Livewire component instance.
Eloquent model FQN?string<Illuminate\Database\Eloquent\Model>$modelThe Eloquent model FQN for the current action, if one is attached.
Mounted actionsarray<Filament\Actions\Action>$mountedActionsThe array of actions that are currently mounted in the Livewire component. This is useful for accessing data from parent actions.
Eloquent record?Illuminate\Database\Eloquent\Model$recordThe Eloquent record for the current action, if one is attached.
SchemaFilament\Schemas\Schema$schema[Actions in schemas only] The schema object that this action belongs to.
Schema componentFilament\Schemas\Components\Component$schemaComponent[Actions in schemas only] The schema component that this action belongs to.
Schema component statemixed$schemaComponentState[Actions in schemas only] The current value of the schema component.
Schema get functionFilament\Schemas\Components\Utilities\Get$schemaGet[Actions in schemas only] A function for retrieving values from the schema data. Validation is not run on form fields.
Schema operationstring$schemaOperation[Actions in schemas only] The current operation being performed by the schema. Usually <code>create</code>, <code>edit</code>, or <code>view</code>.
Schema set functionFilament\Schemas\Components\Utilities\Set$schemaSet[Actions in schemas only] A function for setting values in the schema data.
Selected Eloquent recordsIlluminate\Support\Collection$selectedRecords[Bulk actions only] The Eloquent records selected in the table.
TableFilament\Tables\Table$table[Actions in tables only] The table object that this action belongs to.