/generic-components

A collection of generic web components with a focus on accessibility, and ease of use

Primary LanguageJavaScriptMIT LicenseMIT

generic-components

A collection of generic web components with a focus on:

  • 🚹 Accessibility
  • 🏗 Easy to use
  • 🎨 Easy to style

Goal

The goal of this project is to create a common library of generic web components, that are accessible, framework agnostic, easy to style, and easy to consume.

All components in these repo extend from HTMLElement and dont use any libraries or framework.

You can think of these components like using a native <button> element, you get all the functionality, and accessibility, keyboard navigation, etc., for free, you just have to style the button to your liking.

You can use these components to build an app, or compose them and build your own components with them.

Usage

Via NPM

Components can be installed via NPM:

npm i --save @generic-components/components

And imported in your code via ES imports:

import '@generic-components/components/switch.js';

Via CDN

Alternatively you can load the components from a CDN and drop them in your HTML file as a script tag

<script src="https://unpkg.com/@generic-components/components@latest/switch.js" type="module"></script>
<generic-switch></generic-switch>

Collection

Component Demo Spec Status
generic-accordion demo WAI-ARIA Practices
generic-alert demo WAI-ARIA Practices
generic-dialog demo WAI-ARIA Practices
generic-disclosure demo WAI-ARIA Practices
generic-listbox demo WAI-ARIA Practices
generic-radio demo WAI-ARIA Practices
generic-skiplink demo WebAIM
generic-switch demo WAI-ARIA Practices
generic-tabs demo WAI-ARIA Practices
generic-visually-hidden demo WebAIM