BLACK LIVES MATTER
Be aware. Be angry. Do better. Demand change. Show your support any way you can. Click on the link above to find protests, petitions, and other ways to help. DO NOT LET IT GO SILENT.
Children Variant Plugin for Tailwind CSS
Requirements
This plugin requires Tailwind CSS 1.2 or later. If your project uses an older version of Tailwind, you should install the latest 1.x version of this plugin (npm install tailwindcss-children@1.x
).
Installation
npm install tailwindcss-children
Usage
// tailwind.config.js
module.exports = {
variants: {
display: ['children', 'default', 'children-first', 'children-last', 'children-odd', 'children-even', 'children-not-first', 'children-not-last', 'children-hover', 'hover', 'children-focus', 'focus', 'children-focus-within', 'focus-within', 'children-active', 'active', 'children-visited', 'visited', 'children-disabled', 'disabled', 'responsive'],
},
plugins: [
require('tailwindcss-children'),
],
};
The above configuration would generate the following CSS:
.children\:block > * {
display: block;
}
.block {
display: block;
}
.children\:first\:block > :first-child {
display: block;
}
.children\:last\:block > :last-child {
display: block;
}
.children\:odd\:block > :nth-child(odd) {
display: block;
}
.children\:even\:block > :nth-child(even) {
display: block;
}
.children\:not-first\:block > :not(:first-child) {
display: block;
}
.children\:not-last\:block > :not(:last-child) {
display: block;
}
.children\:hover\:block > :hover {
display: block;
}
.hover\:block:hover {
display: block;
}
.children\:focus\:block > :focus {
display: block;
}
.focus\:block:focus {
display: block;
}
.children\:focus-within\:block > :focus-within {
display: block;
}
.focus-within\:block:focus-within {
display: block;
}
.children\:active\:block > :active {
display: block;
}
.active\:block:active {
display: block;
}
.children\:visited\:block > :visited {
display: block;
}
.visited\:block:visited {
display: block;
}
.children\:disabled\:block > :disabled {
display: block;
}
.disabled\:block:disabled {
display: block;
}
/* etc. */
Which you can then use in your HTML like this:
<ul class="children:block children:not-first:border-t children:border-gray children:hover:bg-gray">
<li>
First item
</li>
<li>
Second item
</li>
<li>
Last item, this one doesn't have a bottom border
</li>
</ul>
You can also override children:
classes on specific children if needed:
<ul class="children:block children:bg-gray">
<li>
First item
</li>
<li class="bg-red">
Second item, this one has a red background
</li>
<li class="bg-blue">
Third item, this one has a blue background
</li>
<li>
Last item
</li>
</ul>
The above depends on the order of the generated CSS, so make sure to add the default
variant after the children
one in the array of variants (as well as the hover
variant after the children-hover
variant if you want to override a children:hover:*
utility, etc.).