Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jhildenbiddle/class-change
A micro-library for manipulating CSS class names, triggering change events using HTML data attributes, and creating declarative class-related event listeners
https://github.com/jhildenbiddle/class-change
attributes change class classlist css data event event-listener html listener polyfill ponyfill
Last synced: about 2 months ago
JSON representation
A micro-library for manipulating CSS class names, triggering change events using HTML data attributes, and creating declarative class-related event listeners
- Host: GitHub
- URL: https://github.com/jhildenbiddle/class-change
- Owner: jhildenbiddle
- License: mit
- Created: 2016-03-05T22:53:30.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-02-07T00:29:44.000Z (8 months ago)
- Last Synced: 2024-08-03T17:07:55.729Z (about 2 months ago)
- Topics: attributes, change, class, classlist, css, data, event, event-listener, html, listener, polyfill, ponyfill
- Language: JavaScript
- Homepage: https://jhildenbiddle.github.io/class-change
- Size: 1.24 MB
- Stars: 14
- Watchers: 2
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# class-change.js
[](https://www.npmjs.com/package/class-change)
[](https://github.com/jhildenbiddle/class-change/actions?query=branch%3Amaster+)
[](https://app.codacy.com/gh/jhildenbiddle/class-change/dashboard?branch=master)
[](https://app.codacy.com/gh/jhildenbiddle/class-change/dashboard?branch=master)
[](https://github.com/jhildenbiddle/class-change/blob/master/LICENSE)
[](https://github.com/sponsors/jhildenbiddle)
A versatile [Element.classList](https://developer.mozilla.org/en/DOM/element.classList) alternative for manipulating CSS class names, triggering class change events using HTML data attributes, and creating class-related event listeners using a simple, declarative API.
- [Documentation](https://jhildenbiddle.github.io/class-change)
- [Codepen Demo](https://codepen.io/jhildenbiddle/pen/wvmYVML)
## Why?
CSS class names change. A lot.
Native methods for manipulating CSS class names are rudimentary given how often we need them. [Element.classList](https://developer.mozilla.org/en/DOM/element.classList) provides a basic API for working with classes, but changes can only be applied to a single element and separate event listeners must be created for each class change event. Legacy browsers also suffer from [incomplete implementations](http://caniuse.com/#feat=classlist) or lack support entirely. The result is unnecessary code bloat and complexity from repeated loops and boilerplate code, polyfills for legacy browsers, and potential performance issues caused by a high volume of event listeners. This micro-library addresses these issues by reducing and simplifying the code required for handling CSS class changes for modern and legacy browsers.
## Features
- Apply class changes to Arrays, CSS Selectors, HTMLCollections, and NodeLists
- Trigger class changes using HTML data attributes
- Create class change event listeners using a simple, declarative API
- Legacy browser support (IE9+)
- ES and UMD modules available
- Lightweight (1.6k min+gzip) and dependency-free
## Usage & Options
See the [documentation site](https://jhildenbiddle.github.io/class-change/) for details.
## Sponsorship
A [sponsorship](https://github.com/sponsors/jhildenbiddle) is more than just a way to show appreciation for the open-source authors and projects we rely on; it can be the spark that ignites the next big idea, the inspiration to create something new, and the motivation to share so that others may benefit.
If you benefit from this project, please consider lending your support and encouraging future efforts by [becoming a sponsor](https://github.com/sponsors/jhildenbiddle).
Thank you! 🙏🏻
## Contact & Support
- Follow 👨🏻💻 **@jhildenbiddle** on [Twitter](https://twitter.com/jhildenbiddle) and [GitHub](https://github.com/jhildenbiddle) for announcements
- Create a 💬 [GitHub issue](https://github.com/jhildenbiddle/class-change/issues) for bug reports, feature requests, or questions
- Add a ⭐️ [star on GitHub](https://github.com/jhildenbiddle/class-change) and 🐦 [tweet](https://twitter.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Fjhildenbiddle%2Fclass-change&hashtags=css,developers,frontend,javascript) to promote the project
- Become a 💖 [sponsor](https://github.com/sponsors/jhildenbiddle) to support the project and future efforts
## License
This project is licensed under the MIT License. See the [LICENSE](https://github.com/jhildenbiddle/class-change/blob/master/LICENSE) for details.
Copyright (c) John Hildenbiddle ([@jhildenbiddle](https://twitter.com/jhildenbiddle))