@coffeekraken/select-webcomponent v0.0.4

Coffeekraken s-select-component

Provide a nice and fully customizable select webcomponent that use a real select as source of truth

Table of content

2. Install
3. Get Started
4. Javascript API
5. SASS API
6. Sugar Web Components Documentation

Install

npm install @coffeekraken/select-webcomponent --save

## Get Started

First, import the component into your javascript file like so:

import SelectWebcomponent from "@coffeekraken/select-webcomponent";

Then simply use it inside your html like so:

<select is="ck-select">
  <option value="value1">Hello</option>
  <option value="value2">World</option>
  <optgroup label="My Cool Group">
    <option value="value3">My Cool Option</option>
  </optgroup>
</select>

The generated html will look like that:

<!-- multiple -->
<div class="ck-select ck-select--multiple">
  <div class="ck-select__selection-container">
    <div class="ck-select__selection-tag">
      Hello
      <span class="ck-select__selection-tag-close"></span>
    </div>
  </div>
  <button type="button" class="ck-select__reset"></button>
  <div class="ck-select__dropdown" style="font-size: 1rem;">
    <div class="ck-select__search-container">
      <input type="search" placeholder="Search..." class="ck-select__search-field" empty="true">
    </div>
    <div class="ck-select__options">
      <div class="ck-select__option ck-select__option--selected">Hello</div>
      <div class="ck-select__option">World</div>
      <div class="ck-select__optgroup">My Cool Group</div>
      <div class="ck-select__option ck-select__option--in-optgroup">My Cool Option</div>
    </div>
  </div>
</div>

<!-- default -->
<div class="ck-select ck-select--opened">
  <div class="ck-select__selection-container">
    <div class="ck-select__selection">Hello</div>
  </div>
  <button type="button" class="ck-select__reset"></button>
  <div class="ck-select__dropdown" style="font-size: 1rem;">
    <div class="ck-select__search-container">
      <input type="search" placeholder="Search..." class="ck-select__search-field" empty="true">
    </div>
    <div class="ck-select__options" style="height: auto; pointer-events: all;">
      <div class="ck-select__option ck-select__option--selected">Hello</div>
      <div class="ck-select__option">World</div>
      <div class="ck-select__optgroup">My Cool Group</div>
      <div class="ck-select__option ck-select__option--in-optgroup">My Cool Option</div>
    </div>
  </div>
</div>

If you need some styling to start with, you can generate it like so:

@use "node_modules/@coffeekraken/select-webcomponent/index" as select-webcomponent;
// only a base bare styling
@include select-webcomponent.classes-bare();
// ...and optionally the visual styles
@include select-webcomponent.classes-style($colors: default primary secondary);
// ...or generate directly the bare and style classes
@include select-webcomponent.classes($colors: default primary secondary);

Coffeekraken

We are a young collective of front-end creative developers with one goal in mind. Build tools to make every team working day life better. This is our first and only concern. All our tools are build around that purpose. All what we provide are some cool tools that you can use the way you want. These tools features cover a large scope of the front-end workflow (styleguide generation, colors/fonts management, etc...). You can use only the parts that you need and let the rest aside...