Skip to content

Metodos expuestos ​

Todos los metodos son accesibles via template ref:

vue
<template>
    <Slider ref="slider" v-model="value" :range="{ min: 0, max: 100 }" />
    <button @click="$refs.slider.reset()">Reset</button>
</template>

Obtener valores ​

get(unencoded?) ​

Retorna el valor actual del slider.

js
// Valor formateado (string)
this.$refs.slider.get();
// → "50.00" (con format) o "50" (sin format)

// Valor numerico crudo
this.$refs.slider.get(true);
// → 50

// Multiples handles
this.$refs.slider.get(true);
// → [20, 80]

TIP

Siempre usa get(true) para obtener valores numericos. get() sin parametro retorna strings.

Establecer valores ​

set(value, fireSetEvent?, exactInput?) ​

Establece el valor del slider.

js
// Un handle
this.$refs.slider.set(75);

// Multiples handles
this.$refs.slider.set([25, 75]);

// Solo cambiar un handle (null = no cambiar)
this.$refs.slider.set([null, 75]); // Solo cambia el segundo

// Sin disparar evento 'set'
this.$refs.slider.set(75, false);

setHandle(index, value, fireSetEvent?, exactInput?) ​

Establece el valor de un handle especifico por indice.

js
// Mover el primer handle a 30
this.$refs.slider.setHandle(0, 30);

// Mover el segundo handle a 70
this.$refs.slider.setHandle(1, 70);

reset(fireSetEvent?) ​

Vuelve a los valores iniciales definidos en start.

js
this.$refs.slider.reset();

// Sin disparar evento
this.$refs.slider.reset(false);

WARNING

reset() solo resetea los valores. No deshace cambios hechos via updateOptions.

Estado ​

setDisable(handleNumber?) ​

Deshabilita el slider completo o un handle especifico.

js
// Deshabilitar todo
this.$refs.slider.setDisable();

// Deshabilitar solo el primer handle
this.$refs.slider.setDisable(0);

setEnable(handleNumber?) ​

Habilita el slider completo o un handle especifico.

js
this.$refs.slider.setEnable();
this.$refs.slider.setEnable(0);

Informacion ​

getSteps() ​

Retorna el step anterior/siguiente disponible por handle.

js
this.$refs.slider.getSteps();
// → [[prev, next], [prev, next]]

getPositions() ​

Retorna las posiciones porcentuales de los handles.

js
this.$refs.slider.getPositions();
// → [20, 80] (porcentajes)

getTooltips() ​

Retorna los elementos HTML de los tooltips.

js
this.$refs.slider.getTooltips();
// → [HTMLElement, HTMLElement]

getOrigins() ​

Retorna los elementos contenedores de los handles.

js
this.$refs.slider.getOrigins();
// → [HTMLElement, HTMLElement]

getOptions() ​

Retorna las opciones actuales del slider.

js
this.$refs.slider.getOptions();
// → { start: [...], range: {...}, step: 1, ... }

Opciones ​

updateOptions(options, fireSetEvent?) ​

Actualiza opciones del slider en tiempo de ejecucion.

js
this.$refs.slider.updateOptions({
    range: { min: 0, max: 200 },
    step: 5,
});

Opciones actualizables

Solo estas opciones se pueden cambiar via updateOptions:

margin, padding, limit, step, range, pips, tooltips, animate, snap

Para cambiar otras opciones (orientation, direction, behaviour, format, connect), el componente las maneja automaticamente al cambiar los props correspondientes.

Pips ​

setPips(config) ​

Crea o actualiza los pips.

js
this.$refs.slider.setPips({
    mode: 'steps',
    density: 3,
});

removePips() ​

Remueve los pips del slider.

js
this.$refs.slider.removePips();

Tooltips ​

removeTooltips() ​

Remueve todos los tooltips.

js
this.$refs.slider.removeTooltips();

Eventos ​

on(event, callback) ​

Registra un evento personalizado de noUiSlider.

js
this.$refs.slider.on('slide', (values, handle) => {
    console.log(values, handle);
});

off(event) ​

Remueve un evento registrado.

js
this.$refs.slider.off('slide');

Destruccion ​

destroy() ​

Destruye el slider y limpia todos los recursos (eventos, tooltips, pips, estilos dinamicos).

js
this.$refs.slider.destroy();

INFO

Normalmente no necesitas llamar destroy() manualmente. El componente lo llama automaticamente en beforeUnmount.

Distribuido bajo la licencia MIT.