Laravel Livewire Tables Documentation
Sponsors Demo Support

Edit

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

This is the documentation for 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

Upgrade Guide

To upgrade from v2 to v3 is relatively simple. The core functionality from v2 is maintained and expects the same parameters.

Common Issues

Views

  • The most common issue occurs when you have previously published the views for this package. When you upgrade, you'll get an error relating to "id" not existing. This is due to a core change within Livewire itself.

We'd always advise that you should not publish this package's views unless you have a need to modify them. If you do choose to publish the views, then you should always remove any published views that you haven't modified, as Laravel will retrieve the core views where the are not published.

The reason for this - there are very regular updates to the views as we introduce new features, or fix bugs.

Keep in mind that there are available methods for changing the majority of classes/attributes across most of the table.

Missing Classes (Tailwind)

When using Tailwind for production, you will typically build and bundle your assets. You should ensure that you have added the following path(s) to your "purge" or "content" sections in your Tailwind config file:

1content: [
2    './vendor/rappasoft/laravel-livewire-tables/resources/views/**/*.blade.php',
3];

It is often wise to add in the path to your Livewire folder (e.g. app/Livewire/**/*.php) too, to ensure that any custom classes you're using are also incldued.

Dark mode (Tailwind)

You must add the following to your Tailwind Config file, for dark mode to use a class-based approach

1darkMode: 'class',

Major Changes

There a few key areas that have been changed, notably:

Custom Assets

The package uses a CSS and JS file, rather than relying on in-line code in the views, you may publish this, use blade directives, use the auto-injection capability (similar to Livewire), or bundle it into your production-ready CSS and JS files. Please see here https://rappasoft.com/docs/laravel-livewire-tables/v3/start/including-assets for more information on available approaches

Reordering

There have been several changes and tweaks to the behaviour of this area, including: