Integration of tailwind css

allan

Only DataTables core is done. None of the extensions have an integration yet. Unfortunately, due to lack of feedback, completing the integration for the extensions isn't a high priority at this time.

Allan

chaerilm

hi, i tried this today, the integration looks broken.
on bootstrap layout goes row by row, where each row puts header, body and footer element. but when i included tailwind.js,

that 'my-2 col-span-2 border border-gray-200 rounded min-w-full bg-white dark:bg-gray-800 dark:border-gray-700' should be on their own line, next last 2 should also use new grid parent.
the content of table is overflowing its parent, and there is no text coloring, even header is unreadable with ' dark:text-gray-50 dark:bg-gray-700/25' color

thanks

chaerilm

found the problem, seems i need to add the files to tailwind's content.

allan

Thanks for the update. Good to hear you've got it working.

Allan

choc

I am trying to customize the Search Builder extension based on https://github.com/DataTables/SearchBuilder/blob/master/src/searchBuilder.bootstrap5.ts and https://datatables.net/extensions/searchbuilder/examples/styling/bootstrap5.html

But when I use the selection options, the input element with the class "dtsb-input" is displayed as soon as the condition is selected, e.g. "Less than".
(P.S. I am using Flowbite and the focus effect of the input element is not working because the input element does not have the type="search". Is there a way to add the type when the input element is created?)

I would like to know if there is a way to prevent these default classes, e.g. dtsb-button and dtsb-dropDown from being displayed so that my tailwind classes can take effect?

Currently, I use this file (https://cdn.datatables.net/1.13.6/js/dataTables.tailwindcss.min.js) and add below snippet with tailwind classes to customize:

$.extend(true, DataTable.SearchBuilder.classes, {
    clearAll: "..."
    });
$.extend(true, DataTable.Group.classes, {
    add: "...",
    clearGroup: "...",
    logic: "..."
    })
$.extend(true, DataTable.Criteria.classes, {
        condition: "...",
        data: "...",
        delete: "...",
        input: "...",
        left: "...",
        right: "...",
        search: "...",
        select: "...",
        value: "...",
    })

I'm not sure if I'm on the right track, do you have any advice for customizing datatables extension with tailwind?
Thank you

choc

I use flowbite buttons (from https://flowbite.com/docs/components/buttons/) and Font Awesome svg icons (https://fontawesome.com/icons) as you can see below what it looks like


(This is the issue with the type of the input element)

(This is how it should be)

Snippet in dataTables.tailwindcss.min.js:

$.extend(true, DataTable.SearchBuilder.classes, {
    clearAll: "float-right mb-3.5 text-gray-900 bg-white border border-gray-300 focus:outline-none hover:bg-gray-100 focus:ring-4 focus:ring-gray-200 font-medium rounded-lg text-sm px-3 py-2 dark:bg-gray-800 dark:text-white dark:border-gray-600 dark:hover:bg-gray-700 dark:hover:border-gray-600 dark:focus:ring-gray-700",

});
$.extend(true, DataTable.Group.classes, {
    add: "relative inline-block truncate text-gray-900 bg-white border border-gray-300 font-medium rounded-lg text-sm px-5 py-2.5",

    clearGroup: "rounded-none m-0 w-8 text-center text-gray-900 bg-white border border-gray-300 focus:outline-none hover:bg-gray-100 focus:ring-gray-200 font-medium text-sm p-2",
    logic: "rounded-none m-0 grow shrink-0 basis-12 text-white bg-gray-800 hover:bg-gray-900 focus:outline-none focus:ring-4 focus:ring-gray-300 font-medium text-sm p-2"
})
$.extend(true, DataTable.Criteria.classes, {
    condition: "p-2 mr-3.5 min-w-20 max-w-80 w-auto pr-8 inline-block bg-gray-50 border border-gray-300 text-gray-900 text-sm rounded-lg focus:ring-blue-500 focus:border-blue-500",
    data: "p-2 mr-3.5 min-w-20 max-w-80 w-auto pr-8 inline-block bg-gray-50 border border-gray-300 text-gray-900 text-sm rounded-lg focus:ring-blue-500 focus:border-blue-500",
    delete: "relative inline-block text-gray-900 bg-white border border-gray-300 focus:outline-none hover:bg-gray-100 focus:ring-4 focus:ring-gray-200 font-medium rounded-lg text-sm py-2.5 px-3.5 mr-3.5 dark:bg-gray-800 dark:text-white dark:border-gray-600 dark:hover:bg-gray-700 dark:hover:border-gray-600 dark:focus:ring-gray-700",
    input: "inline-block bg-gray-50 border border-gray-300 text-gray-900 text-sm rounded-lg focus:ring-blue-500 focus:border-blue-500 p-2.5 dark:bg-gray-700 dark:border-gray-600 dark:placeholder-gray-400 dark:text-white dark:focus:ring-blue-500 dark:focus:border-blue-500",
    left: "mr-3.5 relative inline-block text-gray-900 bg-white border border-gray-300 focus:outline-none hover:bg-gray-100 focus:ring-4 focus:ring-gray-200 font-medium rounded-lg text-sm py-2.5 px-3.5 dark:bg-gray-800 dark:text-white dark:border-gray-600 dark:hover:bg-gray-700 dark:hover:border-gray-600 dark:focus:ring-gray-700",
    right: "mr-3.5 relative inline-block text-gray-900 bg-white border border-gray-300 focus:outline-none hover:bg-gray-100 focus:ring-4 focus:ring-gray-200 font-medium rounded-lg text-sm py-2.5 px-3.5 dark:bg-gray-800 dark:text-white dark:border-gray-600 dark:hover:bg-gray-700 dark:hover:border-gray-600 dark:focus:ring-gray-700",
    select: "w-auto pr-8 inline-block bg-gray-50 border border-gray-300 text-gray-900 text-sm rounded-lg focus:ring-blue-500 focus:border-blue-500",
    value: "p-2 mr-3.5 min-w-20 max-w-80 w-auto pr-8 inline-block bg-gray-50 border border-gray-300 text-gray-900 text-sm rounded-lg focus:ring-blue-500 focus:border-blue-500"
})

Since the searchoption is missing in the cdn version (see: https://datatables.net/forums/discussion/77320?), so I had to use the source code locally and change the source code so that the search button appears which I renam it to Apply (means apply the filter) and I think it's better than the word Search by default.
Note: I manually remove all the default classes from the datatables.min.js file that affect the tailwind classes, e.g., dtsb-button and dtsb-dropDown, ...
Somehow I don't know why I cannot use ! character (means !important;) in dataTables.tailwindcss.min.js file, e.g.,

$.extend(true, DataTable.Group.classes, {
    add: "relative inline-block truncate text-gray-900 bg-white border border-gray-300 font-medium !rounded-lg text-sm px-5 py-2.5",
    clearGroup: "rounded-none m-0 w-8 text-center text-gray-900 bg-white border border-gray-300 focus:outline-none hover:bg-gray-100 focus:ring-gray-200 font-medium text-sm p-2",
    logic: "rounded-none m-0 grow shrink-0 basis-12 text-white bg-gray-800 hover:bg-gray-900 focus:outline-none focus:ring-4 focus:ring-gray-300 font-medium text-sm p-2"
})

or !focus:outline-none

I will get error:

jquery.min.js:2 Uncaught Error: Syntax error, unrecognized expression: .relative.inline-block.truncate.text-gray-900.bg-white.border.border-gray-300.font-medium.!rounded-lg.text-sm.px-5.py-2.5
    at I.error (jquery.min.js:2:11769)
    at Y (jquery.min.js:2:17234)
    at re (jquery.min.js:2:20008)
    at Function.I [as find] (jquery.min.js:2:7520)
    at ce.fn.init.find (jquery.min.js:2:21991)
    at ce.fn.init (jquery.min.js:2:22483)
    at ce (jquery.min.js:2:1077)
    at B.action (datatables_mod.min.js:68:71577)
    at a (datatables_mod.min.js:26:6577)
    at HTMLButtonElement.<anonymous> (datatables_mod.min.js:26:6948)

choc

I figured out how to add the missing type for input elements!
In https://github.com/DataTables/SearchBuilder/blob/master/src/criteria.ts#L525
I insert .attr("type", "text") after the six input elements (Less Than, Less Than Equal to, Greater Than Equal to, Greater Than, Between, and Not Between) and got it to work!

In Line 525:

        let el = $('<input/>')
            .addClass(Criteria.classes.value)
            .addClass(Criteria.classes.input)

fix:

        let el = $('<input/>')
            .attr("type", "text")
            .addClass(Criteria.classes.value)
            .addClass(Criteria.classes.input)

sckramer

Can this be added to a module?
import "https://cdn.datatables.net/2.0.1/js/dataTables.tailwindcss.js"

Getting ReferenceError: DataTable is not defined
at dataTables.tailwindcss.js:9:17

other imports:
import "https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"
import DataTable from "datatables.net"
import "datatables.net"

Works adding everything in the <head> tags...

And a dumb question... how to we actually use this? For example say tweak the <td> padding, dark mode, extend/replace css etc. -- the official way?

allan

And a dumb question... how to we actually use this? For example say tweak the <td> padding, dark mode, extend/replace css etc. -- the official way?

Not a dumb question. This is actually the exact issue that I have with Tailwind. You need to modify these class strings if you want to tweak the classes I've selected. I don't really see what is attractive about that to be honest.

Maybe I'm just too much in the component mind set of Bootstrap and the other styling frameworks, when you just add a "table" class to the table!

And yes, good point about that file not being available as a module. It is there now: https://cdn.datatables.net/2.0.1/js/dataTables.tailwindcss.mjs . It will be in the next npm module release as well.

Allan

sckramer

Interesting... thanks for the links, I'll check everything out!

Getting this on the new .mjs: Uncaught TypeError: Failed to resolve module specifier "jquery". Relative references must start with either "/", "./", or "../".

Tried several ways to import jQuery, npm, html head etc... no change.

allan

How are you defining where the modules should be loaded from?

Allan

sckramer

Here's what I've tried so far...

//import $ from "jquery"
//import { $, jquery } from "jquery"
//import { $, jQuery } from "jquery"
//import $ from "/js/libs/jquery/dist/jquery.js"
//import * as $ from "jquery/dist/jquery"
import { $, jquery } from "/node_modules/jquery/dist/jquery.js"
//import * as jquery from "https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js"

BUT.... maybe jQuery can't be loaded as a module?

in the HTML head...
<head>

console.log("jQuery " + (jQuery ? $().jquery : "NOT") + " loaded")

jQuery 3.7.1 loaded

...still get the error...

ugh ;D Datatables w/o jquery on the horizon?

allan

Import it from https://esm.sh/jquery@3.6.3 (see this blog post). You are right, jQuery 3.x and earlier can't be loaded without a shim. I can't recall if v4 does or doesn't need it.

Do you not need to define where the jquery package can be found though? (similar to the importmap)? I don't know how you are currently building it.

Datatables w/o jquery on the horizon?

Unlikely. It would be a massive amount of work for very little benefit. I'd just be replacing the utility libraries of jQuery with my own, so there would be no real size benefit, and it would be a ton more code to maintain and support.

Allan

sckramer

Building it with Vite... Was thinking and suspect it may just work once you have it as an npm module.

Understood re: no jquery, sounds good!

sckramer

Hi! Is the npm package live?

allan

For DataTables / Tailwind integration? No, I'm afraid not. It won't be until I've completed a full integration with Tailwind for all the extensions of DataTables.

DataTables core and the other styling integrations are available on npm though.

Allan

yajra

Sharing my Vite build of TailwindCSS, DT 2 and Editor integration, hoping that official support will be available soon.

Laravel Demo Project: https://github.com/yajra/laravel-datatables-tailwind-experiment

Integration Script: https://github.com/yajra/laravel-datatables-tailwind-experiment/blob/main/resources/js/dataTables.tailwindcss.js

P.S. This is still a work in progress and just an experimental build.

allan

Very cool! Thank you

Allan

adilsontorres

Hi, while there is no full integration of tailwind on all extensions. How can I modify the buttons (buttons for colvis specifically) to use the tailwind style? Thanks!

allan

Your best best is to look at how it is done for Bootstrap and then modify that to suit your needs.

Allan

jahaganiev

Hey folks,

Jaha is here from Preline UI team. We've just released v2.4.0 update with extensive Datatables integration with core features.

You may check out the demos here: https://preline.co/docs/datatables.html

Integration includes:

• Basic example (sortable columns)
• Selection (select rows with checkboxes)
• Search
• Filters (including column filters)
• Show/Hide columns
• Column actions (move columns left/right)
• Export

If you'll have any issues or requests, please feel free to let us know at Github https://github.com/htmlstreamofficial/preline

Hope that helps!

allan

Awesome - nice one! Thanks for sharing this

Can I add you to the "kits" styling page? (which I've just noticed is missing its images...)

Allan

jahaganiev

Hey Allan,

Absolutely, I would appreciate seeing Preline UI on the Kits page. You might also consider adding a Tailwind section under Styling.

Please feel free to let us know if you have any feedback or need any help with the Datatables + TailwindCSS parts. We would love to work closely with you if you need any assistance from our side.

Cheers,
Jaha

allan

You might also consider adding a Tailwind section under Styling.

There isn't a full integration for DataTables with Tailwind yet. The extensions such as Buttons need that to be added.

I'll be honest, I don't really "get" Tailwind. It seems to me that it is more or less writing styles inline as class names, rather than doing it in CSS. Why remove that separation of concerns?

This is the DataTables integration and it strikes me that customising that would be horrible (padding, colours, any of it - you'd either need to do a replace which is fragile if the default is altered, or copy out all the classes again). Whereas in Bootstrap you just change a CSS variable.

Maybe I'm going about it wrong, or approaching it the wrong way? Any insight would be welcome.

Allan

allan

Link added to the kits page

Allan

jahaganiev

Hey Allan, thanks for adding to Kits page - appreciate it much!

Regarding the utility-first approach vs class based components, there's a great explanation with some examples here https://tailwindcss.com/docs/utility-first

It covers above mentioned concerns and topics like inline styles etc.

However, if you'd like to chat more about my DMs open - please feel free to reach out and I will be more than happy to discuss https://x.com/jahaganiev

Cheers!
Jaha

szogyenyi

Hey everyone,

Just letting you all know that the community from Flowbite created a Tailwind CSS version of the DataTables plugin (one that in fact doesn't even require jQuery).

Cheers!