README

xentixar/dynamic-table is a Filament package that adds dynamic table behavior.

Features

Adds Table::liveSelection() macro for reactive selection syncing.
Supports optional Livewire callback method execution on selection changes.
Registers on both Filament Tables and Archilex Advanced Tables (if installed).

Requirements

PHP 8.2+
Filament Tables ^4.0 || ^5.0
Illuminate Support ^11.0 || ^12.0 || ^13.0

Installation

Install with Composer:

composer require xentixar/dynamic-table

The package uses Laravel package discovery, so the service provider is auto-registered.

Quick Start

Apply liveSelection() on your table definition:

use Filament\Tables\Table;

public static function table(Table $table): Table
{
    return $table
        ->liveSelection();
}

Usage

1) Basic usage

public static function table(Table $table): Table
{
    return $table->liveSelection();
}

2) Conditional enable/disable

public static function table(Table $table): Table
{
    return $table->liveSelection(
        condition: auth()->user()?->can('bulkSelectUsers') ?? false,
    );
}

3) Use custom Livewire property

public static function table(Table $table): Table
{
    return $table->liveSelection(
        livewireProperty: 'selectedUsers',
    );
}

4) Trigger a Livewire method on selection change

public static function table(Table $table): Table
{
    return $table->liveSelection(
        livewireMethod: 'onSelectionChanged',
    );
}

public function onSelectionChanged(
    array $selectedRecords,
    array $deselectedRecords,
    bool $isTrackingDeselectedRecords,
): void {
    // Your logic here
}

If livewireMethod is not provided, the component refreshes automatically.

API Reference

condition (bool, default: true)
- Enable or disable live selection behavior.
livewireProperty (string, default: selectedTableRecords)
- Livewire property used for current selection state.
livewireMethod (?string, default: null)
- Optional Livewire method called when selection changes.
- Receives (array $selectedRecords, array $deselectedRecords, bool $isTrackingDeselectedRecords).

Troubleshooting

Method liveSelection does not exist:
- Run composer dump-autoload and clear app caches (php artisan optimize:clear).
Callback not firing:
- Ensure the method name in livewireMethod matches exactly and is public.
Selection state not where expected:
- Verify the livewireProperty name matches your component property.

License

MIT

See LICENSE for full text.

xentixar / dynamic-table

Maintainers

Package info

Statistics

Security