README

Filament Sticky Table Header

A Filament plugin that makes table headers stick when scrolling down for better UX.

Demo

Installation

You can install the package via composer:

composer require watheqalshowaiter/filament-sticky-table-header

Usage

use WatheqAlshowaiter\FilamentStickyTableHeader\StickyTableHeaderPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            // Other plugins...
            StickyTableHeaderPlugin::make(),
        ]);
}

You may need to run this command to publish assets

php artisan filament:assets

That's it! Your table headers will now stick to the top when scrolling.

Note on scroll to top

If you want to scroll to top on page change (next, previous, etc.), you can add this code inside your PanelProvider page for example AdminPanelProvider.

->plugins([
    StickyTableHeaderPlugin::make()
        ->shouldScrollToTopOnPageChanged()
])

You can configure shouldScrollToTopOnPageChange() like:

->shouldScrollToTopOnPageChanged(enabled: true, behavior: "smooth"); // or 'instant'

Features

✅ Supports Laravel versions: 12, 11, and 10.

✅ Supports PHP versions: 8.4, 8.3, 8.2, and 8.1.

✅ Supports Filament versions: 5.x, 4.x and 3.x.

✅ Fully tested with PHPUnit with 100% code coverage.

✅ Full GitHub Action CI pipeline to format code and test against Filament versions: 5.x, 4.x and 3.x.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

If you have any ideas or suggestions to improve it or fix bugs, your contribution is welcome.

I encourage you to look at Issues which are the most important features that need to be added.

If you have something different, submit an issue first to discuss or report a bug, then do a pull request.

Security Vulnerabilities

If you find any security vulnerabilities don't hesitate to contact me at watheqalshowaiter[at]gmail[dot]com to fix them.

Related Packages

Model Fields - Quickly retrieve required, nullable, and default fields for any Laravel model.
Backup Tables - Backup single or multiple database tables with ease.

watheqalshowaiter / filament-sticky-table-header

Maintainers

Details