Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/excid3/tailwindcss-stimulus-components
A set of StimulusJS components for TailwindCSS apps similar to Bootstrap JS components.
https://github.com/excid3/tailwindcss-stimulus-components
hacktoberfest stimulusjs tailwindcss
Last synced: 1 day ago
JSON representation
A set of StimulusJS components for TailwindCSS apps similar to Bootstrap JS components.
- Host: GitHub
- URL: https://github.com/excid3/tailwindcss-stimulus-components
- Owner: excid3
- License: mit
- Created: 2018-12-07T19:28:42.000Z (almost 6 years ago)
- Default Branch: main
- Last Pushed: 2024-04-03T15:34:01.000Z (8 months ago)
- Last Synced: 2024-04-14T09:08:02.840Z (7 months ago)
- Topics: hacktoberfest, stimulusjs, tailwindcss
- Language: JavaScript
- Homepage: https://excid3.github.io/tailwindcss-stimulus-components/
- Size: 2.56 MB
- Stars: 1,301
- Watchers: 21
- Forks: 129
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: MIT-LICENSE
Awesome Lists containing this project
- awesome-stimulusjs - tailwindcss-stimulus-components - A set of StimulusJS components (tabs, dropdowns, modals, toggles, autosave, etc) for TailwindCSS users. (Packages)
- awesome-hotwire - tailwindcss-stimulus-components - Stimulus components styled with Tailwind CSS. (**Awesome Hotwire** [](https://github.com/sindresorhus/awesome) / Stimulus)
- awesome-hotwire - tailwindcss-stimulus-components - Stimulus components styled with Tailwind CSS. (**Awesome Hotwire** [](https://github.com/sindresorhus/awesome) / Stimulus)
README
[](https://www.npmjs.com/package/tailwindcss-stimulus-components) [](https://github.com/excid3/tailwindcss-stimulus-components/actions/workflows/ci.yml)
# TailwindCSS Stimulus Components
[Check out the demo](https://excid3.github.io/tailwindcss-stimulus-components/)
This is a set of components (Tabs, Modals, Dropdowns, etc) for TailwindCSS that uses [StimulusJS](https://stimulusjs.org) controllers.
The goal is to make using TailwindCSS as easy as Bootstrap when it comes
to adding Javascript components.
## Install
This assumes that [StimulusJS](https://stimulusjs.org) is already installed.
Add the `tailwindcss-stimulus-components` module:
```bash
yarn add tailwindcss-stimulus-components
```
or
```bash
npm install tailwindcss-stimulus-components
```
or use with Rails importmaps:
```bash
bin/importmap pin tailwindcss-stimulus-components
```
## Basic Usage
First, you'll want to initialize StimulusJS and then you can import all the TailwindCSS components.
```javascript
// Start StimulusJS
import { Application } from "@hotwired/stimulus"
const application = Application.start();
// Import and register all TailwindCSS Components or just the ones you need
import { Alert, Autosave, ColorPreview, Dropdown, Modal, Tabs, Popover, Toggle, Slideover } from "tailwindcss-stimulus-components"
application.register('alert', Alert)
application.register('autosave', Autosave)
application.register('color-preview', ColorPreview)
application.register('dropdown', Dropdown)
application.register('modal', Modal)
application.register('popover', Popover)
application.register('slideover', Slideover)
application.register('tabs', Tabs)
application.register('toggle', Toggle)
```
This will start StimulusJS and load any controllers that you have locally and then register the TailwindCSS components.
## Components
* [Alert](/docs/alert.md)
* [Autosave](/docs/autosave.md)
* [Color Preview](/docs/color-preview.md)
* [Dropdown](/docs/dropdown.md)
* [Modal](/docs/modal.md)
* [Popover](/docs/popover.md)
* [Slideover](/docs/slideover.md)
* [Tabs](/docs/tabs.md)
* [Toggle](/docs/toggle.md)
## Utilities
* [transition](/docs/transition.md)
## Styling
All of the styles for the Stimulus components are configurable. Our
examples above show some example styles you can use, but these
components themselves don't require any specific styles.
Stimulus simply requires the `data-` attributes to be defined correctly
to trigger actions and find targets.
Some components like the modal have some styles that are necessary for
proper use in the browser. The container and backgrounds are separate so
that you can have a fixed size container and the modal inside of it.
## Animations
## Extending Components
You can use inheritance to extend the functionality of any Stimulus components.
```js
import { Dropdown } from "tailwindcss-stimulus-components"
export default class ButtonDropdown extends Dropdown {
static targets = ["button"]
connect() {
super.connect();
console.log("the value of button : ", this.buttonTarget.value)
}
}
```
These controllers will automatically have access to `targets` defined in the parent class.
If you override the `connect`, `disconnect` or any other methods from the parent, you'll want to call `super.method()` to make sure the parent functionality is executed.
## Contributing
To develop locally, run `npx serve` and open your browser to the URL it serves on.
Bug reports and pull requests are welcome on GitHub at . This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
To run tests:
```bash
npm install
npm run test
```
## License
This package is available as open source under the terms of the MIT License.