webrouk-custom-range

1.0.4 • Public • Published

webroukCustomRange

Webrouk Custom Range Slider is a lightweight native JavaScript web component for custom range slider element.

  • No dependencies
  • Small and fast
  • Fully responsive
  • Support touch-devices (Android, iOS, Nexus, etc.)
  • Prefixes and suffixes for your numbers ($100, 100k etc.)
  • Slider writes its value right into input value field. This makes it easy to use in any html form

Demo


CodePen Example

Installation


Use NPM to download and install it directly in to your project

$ npm install webrouk-custom-range --save

or include js file manually

<!-- webrouk-custom-range component file -->
<script src="webrouk-custom-range.js"></script>

Usage


Using webroukCustomRange is simple. Configuration over attributes.

<webrouk-custom-range start="0" end="1000" from="300" to="700" prefix-char="$">
  <!-- This input will receive the value from the component -->
  <input type="hidden">
</webrouk-custom-range>

Options

Option Type Description Default
start number Set slider minimum value 0
end number Set slider maximum value 100
from number Set start position for left handle start
to number Set start position for right handle end
prefix-char string Set prefix for values. Will be set up right before the number: $ 100 ''
suffix-char string Set suffix for values. Will be set up right after the number: 100 k ''

Style Customization


Expected CSS Variables from inside the component (optional).

webrouk-custom-range {
  --w-primary-color: hsl(218, 95%, 54%);
  --w-text-color: hsl(0, 100%, 100%);
  --w-line-color: hsl(0, 0%, 93%);
}

Styleable Component Parts


  • root
  • value-start
  • value-end
  • value-from
  • value-to
  • value-single
  • handle
  • handle-lower
  • handle-upper

Example:

webrouk-custom-range::part(value-start) {
  background-color: cornflowerblue;
}

webrouk-custom-range::part(value-end) {
  background-color: indianred;
}

webrouk-custom-range::part(value-from),
webrouk-custom-range::part(value-to) {
  background-color: blueviolet;
}

webrouk-custom-range::part(value-single) {
  background-color: seagreen;
}

License


webroukCustomRange is licensed MIT. It can be used for free and without any attribution, in any personal or commercial project.

Dependencies (0)

    Dev Dependencies (0)

      Package Sidebar

      Install

      npm i webrouk-custom-range

      Weekly Downloads

      3

      Version

      1.0.4

      License

      MIT

      Unpacked Size

      19.6 kB

      Total Files

      5

      Last publish

      Collaborators

      • webrouk