0.9.1 • Published 1 year ago

@trellis-app/kobalte-tailwindcss v0.9.1

Weekly downloads
-
License
MIT
Repository
-
Last release
1 year ago

Warning: this is not the official Kobalte package

Check out https://www.npmjs.com/package/@kobalte/tailwindcss instead.


@trellis-app/kobalte-tailwindcss

A TailwindCSS plugin for styling Kobalte components with data-* attributes by using modifiers like ui-expanded:*.

Installation

npm install -D @trellis-app/kobalte-tailwindcss
# or
yarn add -D @trellis-app/kobalte-tailwindcss
# or
pnpm add -D @trellis-app/kobalte-tailwindcss

Usage

Add the plugin to your tailwind.config.js:

/** @type {import('tailwindcss').Config} */
module.exports = {
	content: [],
	theme: {
		extend: {},
	},
	plugins: [
		// default prefix is "ui"
		require("@trellis-app/kobalte-tailwindcss"),

		// or with a custom prefix:
		require("@trellis-app/kobalte-tailwindcss")({ prefix: "kb" }),
	],
};

Style your component:

import { Popover } from "@trellis-app/kobalte-core";

export const MyPopover = () => (
	<Popover>
		<Popover.Trigger class="ui-disabled:bg-slate-100">Open</Popover.Trigger>
		<Popover.Content class="ui-expanded:shadow-md">...</Popover.Content>
	</Popover>
);

You can use the following modifiers:

ModifierInverse modifier
ui-validui-not-valid
ui-invalidui-not-invalid
ui-requiredui-not-required
ui-disabledui-not-disabled
ui-readonlyui-not-readonly
ui-checkedui-not-checked
ui-indeterminateui-not-indeterminate
ui-selectedui-not-selected
ui-pressedui-not-pressed
ui-expandedui-not-expanded
ui-highlightedui-not-highlighted
ui-currentui-not-current
ui-placeholder-shownui-not-placeholder-shown

It's also possible to use inverse modifiers in the form of ui-not-*, group and peer modifiers in the form of ui-group-* and ui-peer-*.

Documentation

For full documentation, visit kobalte.dev.

Acknowledgment

This plugin is an adaptation of @headlessui/tailwindcss, MIT Licensed, Copyright (c) 2020 Tailwind Labs.

Changelog

All notable changes are described in the CHANGELOG.md file.

0.9.1

1 year ago

0.9.0

1 year ago