guins / vuetensils

🍴 A tasty toolset for Vue.js πŸ›  - Lightweight, functional components to boost your next project.

Home Page:https://vuetensils.stegosource.com/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Introduction

A "naked" component library for Vue.js focused on being:

  • Accessible
  • Semantic
  • Light weight
  • Extensible

Links:

Naked Components

Vuetensil's components are designed to be starting points for some of the most common UI features. They bring all the functionality you would expect from a UI library, but only the bare minimum styles to avoid adding any extra bloat. You can work on the branding, and you don't have to worry about the accessibility.

Import just the features you need (like a WCAG-friendly dialog that traps focus and prevents scrolling), and apply your custom design. No overhead from unused styles!

Getting Started

1. Install the library

npm install vuetensils

2. Register just the components you need

Globally:

// main.js
import Vue from 'vue';
import { VAlert } from 'vuetensils/src/components';

Vue.component('VAlert', VAlert);

Locally:

<script>
// SomeComponent.vue
import { VAlert } from 'vuetensils/src/components';

export default {
  components: {
    VAlert,
  },
  // ...
};
</script>

3. Use the components in your template

<template>
  <div class="some-component">
    <VAlert>Hey, I'm an alert!</VAlert>
  </div>
</template>

4. Bring your own styles

/* Some CSS file */
.vts-alert {
  border: 1px solid currentColor;
  border-radius: 4px;
  padding: 0 10px;
  color: #900;
  background: #FDD;
}

Projects Using Vuetensils

Inspiration

If I want my projects to follow best practices for semantic markup and accessibility, what are my options:

I could write my own library 😱

  • βœ… My styles would be exactly how I want them.
  • βœ… My bundle size will be very small because I'll only use what I need.
  • ❌ It's going to take a lot of time.
  • ❌ I'll have to create every component from scratch.
  • ❌ I probably won't follow all the best practices right.

I could rely on a third party library 😡

  • βœ… It will save me a LOT of time.
  • βœ… I will have many component options to choose from.
  • ❌ I'll still have to confirm they follow best practices.
  • ❌ I will either have to use their styles, or end up overwriting them.
  • ❌ There may be a lot of unused code that could bloat the bundle size.

I could use Vuetensils 😍

  • βœ… The only styles added are the ones I write.
  • βœ… I only include the components I'm actually going to use.
  • βœ… My components will be accessible and semantic.
  • βœ… The bundle size will stay as small as possible.

Roadmap

  • Better a11y range input
  • lazyload directive
  • Tooltip
  • Schema/semantic ratings
  • a11y datetime picker
  • schema/semantic Breadcrumbs
  • finish Datatable
  • Better SSR support
  • functional components
  • Add type export for intellisense
  • Add VLink component
  • Add active class option to VTabs
  • VToggle support a toggle slot with v-bind and v-on
  • VToggle support for accordion
  • VInput default scoped slot with bindings and listeners for label, input, and description.
  • VTry component for error boundaries

About

🍴 A tasty toolset for Vue.js πŸ›  - Lightweight, functional components to boost your next project.

https://vuetensils.stegosource.com/

License:MIT License


Languages

Language:Vue 76.4%Language:JavaScript 23.6%