Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pshihn/emoji-slider

A slider control with emojis
https://github.com/pshihn/emoji-slider

emoji slider webcomponent

Last synced: 3 months ago
JSON representation

A slider control with emojis

Awesome Lists containing this project

README

        

# emoji-slider
A slider control which uses an emoji as the thumb.

This is built as a web component, so it's usable anywhere with HTML.

[View live demo.](https://pshihn.github.io/emoji-slider/demo/)

![Emoji Slider](https://i.imgur.com/RyyBB6B.png)

## Usage

Get the compoent

```
npm install --save emoji-slider
```

Import in a JavaScript module:

``` javascript
import 'emoji-slider';
```

Or in an HTML page:
```html

```

And then use it in HTML

```

```

More about using web components [here](https://lit-element.polymer-project.org/guide/use).

## Properties

**value:** The numeric value of the slider between 0 and 1.

**emoji:** The emoji character to use in the thumb of the slider. If not set, a circular thumb is used.

**step:** The change in value when controlling the slider with keyboard e.g., *Right Arrow Key* will increate the value by 0.1. Default value of *step* is 0.1

## Events
**change** event is fired as the slider value changes. the current value can be obtained from the event details: `event.detail.value`

## Styling
The slider bar color (and active color) be styled using CSS properties. For example,

```css
emoji-slider {
--emoji-slider-bar-color: red;
--emoji-slider-bar-active-color: green;
}
```

## License
[MIT License](https://github.com/pshihn/emoji-slider/blob/master/LICENSE) (c) [Preet Shihn](https://twitter.com/preetster)