README

Filament Table Field

A powerful custom Laravel Filament form field that renders an interactive table to manage related records via HasMany or BelongsToMany relationships — directly within your form.

Built for Filament v3 — no Blade components needed.

🚀 Features

• Inline editable table using Filament Tables API
• Modal-based Create/Edit/Delete actions
• Supports HasMany and BelongsToMany relationships
• Auto-syncs records after form submission
• Dynamic form schema and column config
• Lifecycle hooks:
  • beforeCreateRecord()
  • beforeUpdateRecord()
• Auto-injection of parent form data
• Configurable header actions and table display options
• Customizable empty state

📦 Installation

composer require momenoor/filament-table-field

Register the plugin (if not auto-discovered):

\Momenoor\FilamentTableField\FilamentTableFieldServiceProvider::class,

🔧 Usage

use Momenoor\FilamentTableField\Forms\Components\TableField;

TableField::make('tasks')
    ->relationship('tasks')
    ->tableColumns([
        TextColumn::make('name'),
        TextColumn::make('status')->badge(),
    ])
    ->createFormSchema([
        TextInput::make('name')->required(),
        Select::make('status')->options([
            'new' => 'New',
            'in_progress' => 'In Progress',
            'done' => 'Done',
        ])->required(),
    ])
    ->beforeCreateRecord(fn ($parentState) => [
        'client_id' => $parentState['client_id'] ?? null,
    ])
    ->beforeUpdateRecord(fn ($record) => [
        'updated_by' => auth()->id(),
    ])
    ->heading('Task Assignments')
    ->defaultRecordDefaults([
        'status' => 'new'
    ])
    ->disableEdit(false)
    ->disableDelete(false);

⚙ API Reference

Hooks receive:

• data: submitted form data for that row
• parentState: full parent form state
• state: current field state
• record: the parent model being edited
• field: the TableField instance

📚 License

MIT © Momen Noor