willsprod/ux-datatables

DataTables.net integration for Symfony

1.0.0 2025-08-05 09:11 UTC

Requires

• php: >=8.1
• symfony/config: ^5.4|^6.0|^7.0
• symfony/dependency-injection: ^5.4|^6.0|^7.0
• symfony/http-kernel: ^5.4|^6.0|^7.0
• symfony/stimulus-bundle: ^2.9.1

Requires (Dev)

• symfony/framework-bundle: ^5.4|^6.0|^7.0
• symfony/phpunit-bridge: ^5.4|^6.0|^7.0
• symfony/twig-bundle: ^5.4|^6.0|^7.0
• symfony/var-dumper: ^5.4|^6.0|^7.0

Conflicts

• symfony/flex: <1.13

MIT

• Willy Natan

• symfony
• datatable
• stimulus
• symfony-ux

README

This bundle integrates DataTables.net with Symfony UX using Stimulus.

Features

• Easy integration of DataTables in Symfony projects.

Requirements

• PHP 8.1 or higher
• StimulusBundle
• Composer

Installation

composer require WillsProd/ux-datatables

Make sure StimulusBundle is installed:

composer require symfony/stimulus-bundle

Usage

Build you dataTable in your controller:

$table = new DataTable();

return $this->render('path/to/your/twig', [
    'table' => $table
])

Render the dataTable in your twig template:

render_datatable(table)

Example to show users List in Symfony

    //App/Controller/UserController.php
    #[Route(name: 'app_user_index', methods: ['GET'])]
    public function index(DataTableBuilderInterface $builder): Response
    {
        $table = $builder->createDataTable('userTable');

        $table->setOptions([
            "columns" => [
                ["title" => 'ID'],
                ["title" => 'Email'],
                ["title" => 'Roles'],
                ["title" => 'Actions'],
            ],
            "ajax" => [
                'url' => $this->generateUrl("app_user_list"),
                'dataSrc' => ''
            ],
            'language' => [
                'url' => 'https://cdn.datatables.net/plug-ins/1.13.7/i18n/fr-FR.json' //use https://datatables.net/plug-ins/i18n/ to find your langage
            ],
            "columnDefs" => [
                [
                    "targets" => [0], // ID column
                    "visible" => false,
                    "searchable" => false,
                ],
                [
                    "targets" => [3], // Actions column
                    "className" => "text-base !font-normal text-slate-600 border-b !border-b-slate-100 !p-1 text-right dt-head-right" // Using tailwind classes - you can install tailwind by using composer require symfonycasts/tailwindBundle - Please refer to the official documentation : https://symfony.com/bundles/TailwindBundle/current/index.html
                ],
                [
                    "targets" => [1, 2, 3],
                    "className" => "text-base !font-normal text-slate-600 border-b !border-b-slate-100 !p-1"
                ],
            ],
            "search_input" => [
                "className" => "!border-0 shadow rounded-lg"
            ]
        ]);

        return $this->render('user/index.html.twig', [
            'table' => $table
        ]);
    }

    #[Route("/api/users", name: 'app_user_list', methods: ['GET'])]
    public function usersList(UserRepository $userRepository): JsonResponse
    {
        $showRoute = "app_user_show";
        $editRoute = "app_user_edit";

        return $this->json($userRepository->findUsers($showRoute, $editRoute));
    }

    //App/Repository/UserRepository
    public function findUsers(string $showRoute, string $editRoute): array
    {

        $qb = $this->createQueryBuilder('u');
        $qb->select('u.id', 'u.email', 'u.roles');

        $result = $qb->getQuery()->getScalarResult();

        return array_map(function ($row) use ($showRoute, $editRoute) {
            return [
                $row['id'],
                $row['email'],
                $row['roles'],
                sprintf(
                    "<a href='%s' class='text-blue-500'>Details</a> | <a href='%s' class='text-green-500'>Edit</a>",
                    $this->urlGenerator->generate($showRoute, ['id' => $row['id']]),
                    $this->urlGenerator->generate($editRoute, ['id' => $row['id']])
                )
            ];
        }, $result);
    }

<!-- templates/user/index.html.twig -->
{% extends 'base.html.twig' %}

{% block title %}Users list{% endblock %}

{% block body %}
    <h1 class="text-lg text-slate-600">Users list</h1>
    <div class="p-4 rounded-lg bg-white overflow-x-auto flex flex-col space-y-4">
        <div class="flex items-center">
            <a href="{{ path('app_user_new') }}" class="flex items-center justify-center h-10 rounded-lg px-4 text-white bg-purple-400 duration-150 hover:bg-purple-500">Add user</a>
        </div>
        {{ render_datatable(table) }}
    </div>
{% endblock %}