@minna-ui/select
TypeScript icon, indicating that this package has built-in type declarations

0.36.0 • Public • Published

NPM version NPM bundle size (minified + gzip) Licence

@minna-ui/select

A simple input select web component similar to the browser native <select> but better looking and more enjoyable to use. It can be used standalone, in Svelte projects, or any JavaScript project.

TODO: Write note about @minna-ui/css interplay/dependency.

TODO: Example image.

TODO: Add link to demo and documentation page.

Usage

Standalone

The easiest way to use the component is to add the CDN hosted version directly in your HTML.

TIP: If you're already using a JavaScript bundler you should follow the the "Other JavaScript projects" instructions.

  1. Add the CSS and JS to your document, inside the <head></head>:

     <link href="https://cdn.jsdelivr.net/npm/@minna-ui/select/dist/index.css" rel="stylesheet"/>
    
     <script src="https://cdn.jsdelivr.net/npm/@minna-ui/select"></script>

    Or use a specific version:

    <link
      href="https://cdn.jsdelivr.net/npm/@minna-ui/select@0.5.0/dist/index.css"
      rel="stylesheet"
    />
    
    <script src="https://cdn.jsdelivr.net/npm/@minna-ui/select@0.5.0"></script>
  2. Add an element where you want the component to show in your document <body></body>:

    <div id="minna-select"></div>
  3. Initialise the component:

    <script>
      new MinnaSelect({
        target: document.querySelector('#minna-select'),
        data: {},
      });
    </script>

Svelte projects

Because this is actually a Svelte component, using it in your Svelte projects is simple and allows for the most flexibility and best possible performance.

  1. Install the package:

    yarn add @minna-ui/select
  2. Add to your Svelte component:

    MySvelteComponent.svelte:

    <MinnaSelect />
    
    <script>
      import MinnaSelect from '@minna-ui/select';
    
      export default {
        components: {
          MinnaSelect,
        },
      };
    </script>

Other JavaScript projects

This component can also be used alongside any JavaScript project, regardless of your framework of choice, by using ES6 modules import.

  1. Install the package:

    yarn add @minna-ui/select
  2. Add to your files:

    my-example.html:

    <div id="minna-select"></div>

    my-example.js:

    import MinnaSelect from '@minna-ui/select';
    
    new MinnaSelect({
      data: {},
      target: document.querySelector('#minna-select'),
    });

Licence

@minna-ui/select is part of Minna UI, an Apache-2.0 licensed open source project. See LICENCE.


© 2020 We Are Genki

Package Sidebar

Install

npm i @minna-ui/select

Weekly Downloads

8

Version

0.36.0

License

Apache-2.0

Unpacked Size

250 kB

Total Files

16

Last publish

Collaborators

  • maxmilton