Laravel Livewire Tables Documentation

🎉 Enjoying this package? Consider sponsoring me on GitHub or buying me a beer.

This is the documentation for v2 but the latest version is v3. You can switch versions in the menu at the top. Check your current version with the following command:

composer show rappasoft/laravel-livewire-tables

Multiple Tables Same Page

This feature works for mutiple tables on the same page that are different components.

This feature does not work for multiple tables on the same page that are the same component but take different parameters.


For example, this works:

1<livewire:users-table />
2 
3<livewire:roles-table />

But this does not work:

1<livewire:users-table status="active" />
2 
3<livewire:users-table status="pending" />

If you need the above, you should make them different components like so:

1<livewire:active-users-table />
2 
3<livewire:pending-users-table />

Introduction

By default, your table has a name of table, as well as an internal array called $table which saves its state to the query string.

The query string would look like this:

1// Under the hood
2public array $queryString = [
3 'table' => [
4 'search' => null,
5 'sort' => [],
6 ...
7 ],
8]

In order to have multiple tables on the same page, you need to tell it how to save the state of each table.

Setting the table name and data

If you have multiple tables on the same page and you want them to have independent state saved in the query string, you must set a table name and data array.

1public string $tableName = 'users';
2public array $users = [];

The data array must be the same name as the table name. This data array will remain blank, I tried to create it dynamically in the query string but Livewire doesn't support that, so you have to define it yourself. It is a workaround until Livewire supports dynamic properties for the query string.

Your query string will now look like this:

1// Under the hood
2public array $queryString = [
3 'users' => [
4 'search' => null,
5 'sort' => [],
6 ...
7 ],
8 // Other tables
9 'roles' => [
10 'search' => null,
11 'sort' => [],
12 ...
13 ],
14]

Disabling the query string for multiple of the same component

If you must have multiple of the same component on the same page, you should disable the query string for those components so the query string state does not get replaced by one or the other:

1public function configure(): void
2{
3 $this->setQueryStringDisabled();
4}

Disabling column selection for multiple of the same component

You should also disable the columns selection for those components so the column selection state does not get replaced by one or the other:

1public function configure(): void
2{
3 $this->setColumnSelectStatus(false);
4}