Formulários

VSlider

Componentev-model10 exemplos16 propsA2UI · Slider

Controlo deslizante para selecionar valores numéricos ou intervalos, com suporte a marcos, orientação vertical e acessibilidade por teclado.

Importação
<script setup lang="ts">
import { VSlider } from 'vueui-nova-kit'
</script>

Uso

Exemplo
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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
vue
<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

TriggerPropertyDurationEasing
Thumb hover/focusbox-shadow100msease-out
Tooltipopacity/scale100msease-out
Dragtransform100msease-out

Respeitar prefers-reduced-motion.

Todas as transições respeitam prefers-reduced-motion e os tokens --v-duration-*.

Props

PropTipoDefaultDescrição
modelValueVSliderModelValue0—
minnumber0—
maxnumber100—
stepnumber1—
rangebooleanfalse—
marksnumber[] | Record<number, string>——
orientationVSliderOrientation"horizontal"—
disabledbooleanfalse—
sizeVSliderSize"md"—
showValuebooleantrue—
showTooltipbooleantrue—
snapToMarksbooleanfalse—
ariaLabelstring——
idstring——
motionVMotionLevelV_MOTION_DEFAULT ("expressive")—
trackBackgroundstring—Fundo do track (ex.: gradiente do hue no VColorPicker). Aplicado inline sobre o token neutro.

Events

EventoPayloadDescrição
@update:modelValuevalue: number | [number, number]—
@changevalue: number | [number, number]—

Slots

Sem slots.

Fonte: src/components/form/VSlider/VSlider.vue · tipos: src/components/form/VSlider/VSlider.types.ts