Introducing Classlist

We like Tailwind CSS. And we like ViewComponent. And we like using ViewComponent to encapsulate the long lists of CSS classnames you inevitably get using Tailwind CSS.

So we made Classlist, a Ruby implementation of DOMTokenList, which is what Element.classlist in the DOM returns.

What does it do?

Classlist allows us to create, manipulate and pass around lists of classnames like so:

classes = Claslist.new
classes.add("rounded-full")
classes.add("w-24 h-24")

which we then can output in our components

<img class="<%= classes %>">

That’s not all

Classlist implements all the parts of the DOMTokenList API (the parts that make sense in a server-side setting, at least). This allows us to both add, remove, replace, and toggle classnames in the list.

classes = Classlist.new("text-lg") #=> "text-lg"
classes.add("font-medium") #=> "text-lg font-medium"
classes.remove("text-lg") #=> "font-medium"
classes.toggle("hidden") #=> "font-medium hidden"
classes.replace("font-medium", "font-bold") #=> "font-bold hidden"

But wait, there’s more

Ever so often you find that one exception to the rule, where the padding (or whatever) on a component needs to be different than everywhere else, and creating a whole new variant for this is too cumbersome.

Most our components now have a Classlist instance managing the class names on their outermost element. Something like

<div class="<%= classes %>">
  ... rest of the component goes here...
</div>

and they accept a list of CSS classnames when rendered:

<%= render(ButtonComponent.new(:classes => "bg-red")) %>

Using Classlist we can now manipulate the final set of class names on the component from the caller. If a button needs a different padding than the one already implemented, we can do

<%= render(ButtonComponent.new(:classes => Classlist::Remove.new("p-4") + Classlist::Add.new("px-3 py-2")) %>

This would remove a p-4 class from the default list and add px-3 and py-2 without us having to implement and name an entirely new variant.

Where can you get it?

Not only did we build Classlist, we’ve also open sourced it. We’re already using this in a largish Rails + Slim + View Component codebase, so if you’ve find yourself nodding at some of the above problems, do not hesitate giving it a run:

https://github.com/substancelab/classlist/