Noiseless Party Machine

    vuetensils
    TypeScript icon, indicating that this package has built-in type declarations

    0.12.1 • Public • Published

    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 and no wrestling with overly-specific styles.

    Getting Started

    1. Install the library

    npm install vuetensils

    2. Register just the things you need

    Globally:

    // main.js
    import { VAlert } from 'vuetensils/src/components';
    import { autofocus } from 'vuetensils/src/directives';
    
    // With your previously created app
    app.component('VAlert', VAlert);
    app.directive('autofocus', autofocus);

    Locally:

    <script>
    // SomeComponent.vue
    import { VAlert } from 'vuetensils/src/components';
    import { autofocus } from 'vuetensils/src/directives';
    
    export default {
      components: {
        VAlert,
      },
      directives: {
        autofocus,
      },
      // ...
    };
    </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;
    }

    Inspiration

    I've built a lot of projects in the past and found myself copy/pasting several of the same components over and over, and stripping out styles that I didn't need. Eventually I realized that I could just create components with the base functionality and accessible markup, but no styles at all. That way, I wouldn't have to wrestle with existing styles, or worry about bloating my app with overwritten styles.

    Install

    npm i vuetensils

    DownloadsWeekly Downloads

    638

    Version

    0.12.1

    License

    MIT

    Unpacked Size

    428 kB

    Total Files

    104

    Last publish

    Collaborators

    • stegosource