Tailwindcss Parser is an open-source library for parsing Tailwind CSS classes into an Abstract Syntax Tree (AST) and AST to classname. This allows for easier manipulation and analysis of Tailwind CSS classes in a declarative manner. If you are into a WYSIWYG like CMS builders this library can parse classes from blocks (or whatever you are using as a name for your components) or convert class definitions into classnames into your blocks.
Inspired by the Tailwind CSS v4.0.0's candidate.ts
parser.
It is probably missing many Tailwind classes and might throw some exceptions. You can create a PR to add Tailwind class names to the plugins.ts
file to support class names that I've missed.
You can install the Tailwindcss Parser via npm:
npm install @xengine/tailwindcss-class-parser
To use the Tailwindcss Parser, you need to import the parse
function from the package and pass the Tailwind CSS class you want to parse. The function returns an AST representation of the class.
import { parse } from '@xengine/tailwindcss-class-parser';
const ast = parse('lg:hover:text-red-500/70');
console.log(ast);
/*
Output:
{
root: "text",
property: "textColor",
value: {
value: "#ef4444",
kind: "color",
class: ["color"],
raw: "red-500"
},
modifier: "70",
variants: [
{
kind: "named",
type: "interaction",
value: "hover"
},
{
kind: "named",
type: "media",
value: "lg"
}
],
important: false,
negative: false
}
*/
Parses a given Tailwind CSS class and returns an AST object.
-
className
(string): The Tailwind CSS class to parse.
-
object
: The AST representation of the Tailwind CSS class.
Converts a given Tailwind CSS AST to the original class string.
-
ast
(object): small Tailwind CSS declaration
AstDeclaration = {
property: string
value: string
variants?: Variant[]
modifier?: string,
important?: boolean
negative?: boolean,
}
-
className
(string): The Tailwind CSS class.
Contributions are welcome! Please feel free to submit a pull request or open an issue on GitHub.
Special thanks to the Tailwind CSS team for their amazing work on Tailwind CSS.
@siddharthkp from https://github.com/ui-devtools/tailwind-utils