README

Filter components for Accelade - text, select, date, boolean and custom filters for tables and grids.

Installation

composer require accelade/filters

Quick Start

use Accelade\Filters\FilterPanel;
use Accelade\Filters\Components\TextFilter;
use Accelade\Filters\Components\SelectFilter;

$panel = FilterPanel::make()
    ->filters([
        TextFilter::make('search')
            ->label('Search')
            ->placeholder('Search users...'),

        SelectFilter::make('status')
            ->label('Status')
            ->options([
                'active' => 'Active',
                'inactive' => 'Inactive',
            ]),
    ]);

Documentation

• Overview - Introduction to filter components
• Text Filter - Text/search filter component
• Select Filter - Dropdown/select filter component
• Boolean Filter - Boolean/toggle filter component
• Number Filter - Number filter component
• Date Filter - Date filter component
• Date Range Filter - Date range filter component
• Filter Layouts - Different layout options for filter panels
• Filter Panel - Container for managing filter collections
• Query Builder - Complex nested filtering with AND/OR grouping

Development

Building TypeScript

cd packages/filters
npm install
npm run build

Running Tests

composer test

Code Quality

composer format      # Format PHP code with Pint
composer mago        # Run Mago linter

Requirements

• PHP 8.2+
• Laravel 11.0+
• Accelade 1.0+

License

MIT License. See LICENSE for details.