Global Defaults

Static methods on TableBuilder let you configure defaults once in a service provider so every table inherits them.

Where to Set

use TranquilTools\TableBuilder\TableBuilder;

public function boot(): void
{
    TableBuilder::defaultPerPageOptions([10, 25, 50, 100]);
    TableBuilder::defaultPerPage(25);
    TableBuilder::defaultSearchDebounce(350);
    TableBuilder::defaultResetButton(true);
    TableBuilder::defaultPaginationScroll('top');
    TableBuilder::hidePaginationWhenResourceContainsOnePage(false);
    TableBuilder::defaultColumnCanBeHidden(true);
    TableBuilder::defaultHighlightFirstColumn(false);
    TableBuilder::defaultGlobalSearch(false);
}

Reference

Pagination

Method	Default	Description
`TableBuilder::defaultPerPageOptions(array)`	`[10, 25, 50, 100]`	Available per-page options for every table
`TableBuilder::defaultPerPage(int)`	`25`	Default items per page when no `?perPage` query param is set
`TableBuilder::hidePaginationWhenResourceContainsOnePage(bool)`	`false`	Hide pagination controls when all results fit on one page
`TableBuilder::defaultPaginationScroll(string)`	`'top'`	Scroll to `'top'` on page change, or `''` for no scroll

Search

Method	Default	Description
`TableBuilder::defaultSearchDebounce(int $ms)`	`350`	Milliseconds to debounce search input changes
`TableBuilder::defaultGlobalSearch(string\|false)`	`false`	Enable global search on all tables with an optional label; `false` disables

Columns

Method	Default	Description
`TableBuilder::defaultColumnCanBeHidden(bool)`	`true`	Whether columns are toggleable by default
`TableBuilder::defaultHighlightFirstColumn(bool)`	`false`	Visually highlight the first column on all tables

UI

Method	Default	Description
`TableBuilder::defaultResetButton(bool)`	`true`	Show a reset button when any filter/search/sort is active

Per-Table Overrides

Any default can be overridden on an individual table:

public function configure(TableBuilder $table): void
{
    $table
        ->perPageOptions([5, 10, 25])   // override per-page options
        ->withoutGlobalSearch()          // remove global search for this table
        ->name('orders');
}

Reading Defaults

TableBuilder::getDefaultPerPage();          // int
TableBuilder::getDefaultSearchDebounce();   // int
TableBuilder::getDefaultResetButton();      // bool
TableBuilder::getDefaultPaginationScroll(); // string
TableBuilder::hidesPaginationWhenResourceContainsOnePage(); // bool