vue-double-range-input

Double range input for vue 3 with min and max value that help you select two value with one input.
One of important usage is in shops for filtering between min and max price.

How to use

Install package

Run this code to install this package:

npm i vue-double-range-input

Then You should Import component's style:

import 'vue-double-range-input/dist/style.css';

Now you can import package:

import VueDoubleRangeInput from 'vue-double-range-input';

This is a simple version of component with minimum props that needed:

<VueDoubleRangeInput :min="min"
                     :max="max"
                     v-model:minValue="minValue"
                     v-model:maxValue="maxValue" />

Default number slot

If you want to change the text of numbers, you can do it like below:

<VueDoubleRangeInput :min="min"
                     :max="max"
                     v-model:minValue="minValue"
                     v-model:maxValue="maxValue">
  <!-- Do not change minValueRef and maxValueRef spelling -->
  <template #from="{ minValueRef }">
    از: {{ (Number(minValueRef)).toLocaleString('fa-IR') }}
  </template>
  <template #to="{ maxValueRef }">
    تا: {{ (Number(maxValueRef)).toLocaleString('fa-IR') }}
  </template>
</VueDoubleRangeInput>

Get only numbers

If you only want to get min and max value and show it where you want, you can do it like below:

const min = ref(0);
const max = ref(100);
const minValue = ref(25);
const maxValue = ref(75);

const outMinValueRef = ref(0);
const outMaxValueRef = ref(0);

function outMinValue(val) {
  outMinValueRef.value = val;
}
function outMaxValue(val) {
  outMaxValueRef.value = val;
}

<div>
  {{ outMinValueRef }}
  <br />
  {{ outMaxValueRef }}
</div>
<VueDoubleRangeInput :min="min"
                     :max="max"
                     v-model:minValue="minValue"
                     v-model:maxValue="maxValue">
  <template #from="{ minValueRef }">
    {{ outMinValue(minValueRef) }}
  </template>
  <template #to="{ maxValueRef }">
    {{ outMaxValue(maxValueRef) }}
  </template>
</VueDoubleRangeInput>

Change minValue and maxValue by input

Use :value and @change if you want to change values in an input.

Note: If you want to change component values from outside, its better to use :value and @change like below. Otherwise you may see some weird issues.

<div>
  <input type="text" name="min_value" id="min_value"
         :value="minValue"
         @change="minValue = $event.target.value">
  <input type="text" name="max_value" id="max_value"
         :value="maxValue"
         @change="maxValue = $event.target.value">
</div>

Complete example

This one has everything that you can do on this component:

<div>
  <input type="text" name="min_value" id="min_value"
         :value="minValue"
         @change="minValue = $event.target.value">
  <input type="text" name="max_value" id="max_value"
         :value="maxValue"
         @change="maxValue = $event.target.value">
</div>
<VueDoubleRangeInput dir="rtl"
                     step="5"
                     color="#2497E3"
                     track-color="rgba(100,100,100,0.5)"
                     track-radius="5px"
                     track-height="10px"
                     handler-color="#2497E3"
                     handler-radius="5px"
                     handler-width="24px"
                     handler-height="24px"
                     :push-on-touch="false"
                     :show-numbers="true"
                     :min="min"
                     :max="max"
                     v-model:minValue="minValue"
                     v-model:maxValue="maxValue">
  <template #from="{ minValueRef }">
    از: {{ (Number(minValueRef)).toLocaleString('fa-IR') }}
  </template>
  <template #to="{ maxValueRef }">
    تا: {{ (Number(maxValueRef)).toLocaleString('fa-IR') }}
  </template>
</VueDoubleRangeInput>

List of props and default values

|prop |default |description| |----------------|----------------| --- | |dir |ltr | don't use it if your want to be ltr or just put ltr in it.| |step |null |just like step in normal range input.| |color |#2497E3 |color of line between two value (accept all css color selector).| |track-color |#cccccc |set color of full track in behind (accept all css color selector).| |track-height |9px |set height for track.| |track-radius |9999px |set border-radius for track.| |handler-color |#2497E3 |set color of circle handlers of input range (accept all css color selector).| |handler-radius |9999px |set border-radius for handlers.| |handler-width |24px |set width for handlers.| |handler-height |24px |set height for handlers.| |show-numbers |true |set it to false if you want to hide "from" and "to" numbers.| |push-on-touch |true |false: min value cannot go above max value and max value cannot go below min value. true: if min value become greater than max value, max value automatically set to min value and vise versa.| |min |0 |same as min in normal range input.| |max |100 |same as max in normal range input.| |v-model:minValue|25 |same as value in normal range input but for min.| |v-model:maxValue|75 |same as value in normal range input but for max.| |---------------------------|----------|--------|