Formulários
VSlider
Controlo deslizante para selecionar valores numéricos ou intervalos, com suporte a marcos, orientação vertical e acessibilidade por teclado.
<script setup lang="ts">
import { VSlider } from 'vueui-nova-kit'
</script>Uso
<script setup lang="ts">
</script>
<template>
</template>Playground
Os controles abaixo são gerados a partir das props declaradas em VSlider.types.ts; o código acompanha cada mudança.
Exemplos
Variantes, tamanhos e estados, extraídos das stories da biblioteca.
Default
Variação Padrão. Estado padrão do componente; use a aba Controls para experimentar as props ao vivo. Props: modelValue=40, ariaLabel="Volume".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(40)
</script>
<template>
<VSlider v-model="value" aria-label="Volume" />
</template>Range
Variação Range. Props: range=true.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref([20, 80])
</script>
<template>
<VSlider v-model="value" range />
</template>With Marks
Variação Com Marks. Props: modelValue=50.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(50)
const marks = [0, 25, 50, 75, 100]
</script>
<template>
<VSlider v-model="value" :marks="marks" />
</template>Vertical
Variação Vertical. Props: orientation="vertical", modelValue=75, ariaLabel="Brightness".
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(75)
</script>
<template>
<VSlider v-model="value" orientation="vertical" aria-label="Brightness" />
</template>Disabled
Variação Desabilitado. Props: disabled=true, modelValue=30.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(30)
</script>
<template>
<VSlider v-model="value" disabled />
</template>Sizes
Variação Tamanhos.
Ver código
<script setup lang="ts">
import { VSlider } from 'vueui-nova-kit'
</script>
<template>
<div style="display:flex;flex-direction:column;gap:24px;max-width:420px">
<VSlider size="sm" :model-value="40" aria-label="Small slider" />
<VSlider size="md" :model-value="40" aria-label="Medium slider" />
<VSlider size="lg" :model-value="40" aria-label="Large slider" />
</div>
</template>Interactive
Variação Interativo. Interativo: o estado é mantido na própria story (v-model).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(80)
const range = ref([
20,
80
])
</script>
<template>
<div style="display:flex;flex-direction:column;gap:24px;max-width:420px">
<VSlider v-model="value" aria-label="Volume" />
<VSlider v-model="range" range aria-label="Price range" />
</div>
</template>Show Value Tooltip
Variação Show Value Tooltip. Props: modelValue=40, showValue=true, showTooltip=true.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(40)
</script>
<template>
<VSlider v-model="value" />
</template>Snap To Marks
Variação Snap para Marks. Props: modelValue=50, snapToMarks=true, step=1.
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(50)
const marks = [0, 25, 50, 75, 100]
</script>
<template>
<VSlider v-model="value" :marks="marks" snap-to-marks />
</template>Track Background
Variação Track Background. Props: trackBackground (ex.: gradiente do hue usado pelo VColorPicker).
Ver código
<script setup lang="ts">
import { ref } from 'vue'
import { VSlider } from 'vueui-nova-kit'
const value = ref(120)
</script>
<template>
<VSlider
v-model="value"
:max="360"
aria-label="Hue"
track-background="linear-gradient(90deg, #f00, #ff0, #0f0, #0ff, #00f, #f0f, #f00)" />
</template>Acessibilidade
role="slider", aria-valuenow/aria-valuetext, aria-orientation, suporte a Arrow/Home/End/PageUp/PageDown, área de acerto mínima 44×44px.
Estados
Default · Hover · Focus-visible · Dragging · Disabled.
Motion
| Trigger | Property | Duration | Easing |
|---|---|---|---|
| Thumb hover/focus | box-shadow | 100ms | ease-out |
| Tooltip | opacity/scale | 100ms | ease-out |
| Drag | transform | 100ms | ease-out |
Respeitar prefers-reduced-motion.
Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.
Props
| Prop | Tipo | Default | Descrição |
|---|---|---|---|
modelValue | VSliderModelValue | 0 | — |
min | number | 0 | — |
max | number | 100 | — |
step | number | 1 | — |
range | boolean | false | — |
marks | number[] | Record<number, string> | — | — |
orientation | VSliderOrientation | "horizontal" | — |
disabled | boolean | false | — |
size | VSliderSize | "md" | — |
showValue | boolean | true | — |
showTooltip | boolean | true | — |
snapToMarks | boolean | false | — |
ariaLabel | string | — | — |
id | string | — | — |
motion | VMotionLevel | V_MOTION_DEFAULT ("expressive") | — |
trackBackground | string | — | Fundo do track (ex.: gradiente do hue no VColorPicker). Aplicado inline sobre o token neutro. |
Events
| Evento | Payload | Descrição |
|---|---|---|
@update:modelValue | value: number | [number, number] | — |
@change | value: number | [number, number] | — |
Slots
Sem slots.
Fonte: src/components/form/VSlider/VSlider.vue · tipos: src/components/form/VSlider/VSlider.types.ts