DataTable

Reference for the DataTable fluent configuration API

DataTable is the fluent API used to configure table options, columns, extensions, and loading mode.

Constructor

new DataTable(
    id: 'users',
    options: [],
    attributes: [],
    extensions: [],
)

Core Methods

Columns

Method	Description
`add(ColumnInterface $column)`	Add a single column
`columns(array $columns)`	Replace the column list with the given array
`getColumns(): ColumnInterface[]`	Return configured column objects keyed by name
`getColumnDefinitions(): array`	Return the serialized DataTables column definitions
`getColumnByName(string $name): ?ColumnInterface`	Find a column by its name

Client-side Processing And Data Sources

Method	Description
`ajax(string $url, ?string $dataSrc = null, string $type = 'GET')`	Configure Ajax endpoint and request mode
`ajaxRequestData(string $url, array $data, string $type = 'GET')`	Configure Ajax endpoint with extra request data sent on every call
`mergeAjaxData(array $data)`	Merge additional key/value pairs into Ajax request data
`data(array $data)`	Provide inline client-side data
`forwardQueryParameters(array $parameters)`	Capture the named page query parameters at render time and forward them on every Ajax call
`urlState(array $keys = [], string $prefix = '')`	Sync selected DataTables state keys to the page URL query string
`serverSide(bool $serverSide = true)`	Enable server-side processing mode
`apiPlatform(bool $enabled = true)`	Enable API Platform adapter behavior
`mercure(array $topics = [], bool $withCredentials = false, ?int $debounceMs = null)`	Enable Mercure live updates with one or many topics

Feature Control

Method	Description
`autoWidth(bool $autoWidth)`	Toggle automatic width calculation
`deferRender(bool $deferRender)`	Delay rendering of non-visible rows
`info(bool $info)`	Show/hide table info summary
`lengthChange(bool $lengthChange)`	Enable/disable page-size selector
`ordering(bool $handler = true, bool $indicators = true)`	Configure column ordering behavior
`withoutOrdering()`	Disable ordering
`paging(...)`	Configure pagination behavior
`withoutPaging()`	Disable pagination
`processing(bool $processing = true)`	Toggle processing indicator
`searching(bool $searching = true)`	Toggle global search
`stateSave(bool $stateSave = true)`	Persist table state in browser
`setPermission(string\|Expression $attribute)`	Restrict table rendering and bundle Ajax access with a Symfony security attribute or expression

Layout And Paging

Method	Description
`layout(array $layout)`	Position DataTables UI blocks
`caption(string $caption)`	Set the table caption text
`displayStart(int $displayStart)`	Set initial row offset
`lengthMenu(array $lengthMenu)`	Configure available page sizes
`pageLength(int $pageLength)`	Set default page size

Method	Description
`editModalTemplate(string $template)`	Twig template used for the inline edit modal
`editModalAdapter(string $adapter)`	Modal adapter name (`bootstrap`, `custom`, …)

Scrolling

Method	Description
`scrollX(bool $scrollX)`	Enable horizontal scrolling
`scrollY(string $scrollY)`	Set vertical scroll height

Internationalization

Method	Description
`language(Language $language)`	Set UI language
`search(string $search)`	Set initial search value
`withSearchOption(SearchOption $searchOption)`	Set full search option object

Styling

Method	Description
`styleFramework(StyleFramework $framework)`	Declare the CSS framework, skipping frontend autodetection

Extensions

Method	Description
`addExtension(ExtensionInterface $extension)`	Add one extension
`extensions(array $extensions)`	Set multiple extensions
`getExtensions(): array`	Return configured extensions
`setExtensions(DataTableExtensions $extensions)`	Replace extension collection
`responsive()`	Convenience helper for the Responsive extension
`columnControl(int\|string\|null $target = null, ?array $content = null)`	Add Column Control; a target replaces the defaults with that single control group

Example

use Pentiminax\UX\DataTables\Enum\Feature;
use Pentiminax\UX\DataTables\Enum\Language;
use Pentiminax\UX\DataTables\Model\DataTable;

$table = (new DataTable('users'))
    ->serverSide(true)
    ->processing(true)
    ->language(Language::EN)
    ->layout([
        'topStart'    => Feature::PAGE_LENGTH,
        'topEnd'      => Feature::SEARCH,
        'bottomStart' => Feature::INFO,
        'bottomEnd'   => Feature::PAGING,
    ]);

Cross Links