README.md

Single and Multi Select Web Component

Compatible select web component which works with any framework or no framework. This component is created using stencilJs

Demo

Demo link - https://select-component.netlify.app/

Features

• Single Select
• Multi-select
• Accessiblitiy
• Clear options
• Select/Deselect options

Usage/Examples

For Single select in react,

  let [singleSelectValue, setSingleSelectValue] = useState('football');

  return (
    <select-web 
        value={singleSelectValue}
        onChange={(e) => setSingleSelectValue(e.target.value)}
    >
        <select-web-option value="football">Footbal</select-web-option>
        <select-web-option value="cricket">Cricket</select-web-option>
        <select-web-option value="duster">Duster</select-web-option>
        <select-web-option value="basket">Basket</select-web-option>
    </select-web>
  )

For Multi select in react,

• Pass multipe=true attribute to the select-web component
• As HTML does not allow to pass array as attribute, strigify the array and then pass in value attribute as below

let [multiSelectValue, setMultiSelectValue] = useState(['football']);

return (
    <select-web 
        multiple
        value={JSON.stringify(multiSelectValue)}
        onChange={(e) => setMultiSelectValue([...e.target.value])}
    >
        <select-web-option value="football">Footbal</select-web-option>
        <select-web-option value="cricket">Cricket</select-web-option>
        <select-web-option value="duster">Duster</select-web-option>
        <select-web-option value="basket">Basket</select-web-option>
    </select-web>
)

Shortcuts

• space / enter: toggles the dropdown
• up, down: navigates up and down the dropdown items
• enter: to select/deselect the dropdown item

Run Locally

Clone the project

  git clone https://github.com/prashanthsasidharan/select-web-component.git

Go to the project directory

  cd select-web-component

Install component dependencies

  cd component, yarn

Component server runs at http://localhost:3000/

  Yarn start

Install Ember-demo dependencies

  cd ember-demo, yarn

Ember-demo server runs at http://localhost:3001/

  yarn start

Install React-demo dependencies

  cd react-select-demo, yarn

React-demo server runs at http://localhost:3002/

  yarn start

Install Plain-js-demo dependencies

  cd plain-demo

Plain-js-demo server runs at http://localhost:3003/

  yarn start

View the app using http://localhost:3000/ in browser tab

License

MIT

Badges

Tech Stack

Component: Stencil js

Demos: Ember, React, Vanilla js

🔗 Links

Contributing

Contributions are always welcome!