Slider

Os sliders indicam visualmente um conteúdo ajustável, onde o usuário pode mover o controlador sobre uma linha horizontal para aumentar ou diminuir um valor. Eles são ideais para ajustar configurações como filtros de valores de apartamentos, metro quadrado ou também ajustar a porcentagem de algum financiamento.

Playground

Propriedades

Nome (* = obrigatório)

Tipo

Valores

Descrição

id *

string

Identificador do Slider. O id é obrigatório para garantir acessibilidade. Irá vincular um atributo aria-labelledby no Slider à Label do mesmo.

name

string

Atributo name para ser repassado para o input associado ao Slider.

label

string

Label do Slider.

value

number | readonly number[]

O valor do Slider. Deve ser usado quando se deseja utilizar o componente de forma controlada. Passar um único número fará um Slider ser de um valor único, passar uma tupla com dois números fará o Slider ser um range.

defaultValue

number | readonly number[]

O valor inicial do Slider. Deve ser usado quando se deseja utilizar o componente de forma não-controlada. Passar um único número fará um Slider ser de um valor único, passar uma tupla com dois números fará o Slider ser um range. Por padrão, é 0.

min

number

O valor mínimo do Slider. Por padrão, é 0.

max

number

O valor máximo do Slider. Por padrão, é 100.

step

number

Define de quanto em quando o seletor do Slider se move. Por padrão, é 1.

inputControl

boolean

  • false (default)

  • true

Quando true, mostra campos de texto com o valor atual do Slider.

disabled

boolean

  • false (default)

  • true

Se o Slider está habilitado ou não. Quando true, o componente torna-se não-interativo.

Métodos

Nome (* = obrigatório)

Tipo

Descrição

onAfterChange: (value: number | readonly number[], index: number)

function

Função chamada quando há uma mudança de valor.

value é o valor após da mudança e index pode ser 0 ou 1, representando o índice do value quando o mesmo for uma tupla.

onChange: (value: number | readonly number[], index: number)

function

Função chamada em toda mudança de valor.

value é o valor da mudança e index pode ser 0 ou 1, representando o índice do value quando o mesmo for uma tupla.

onBeforeChange: (value: number | readonly number[], index: number)

function

Função chamada quando há uma mudança de valor.

value é o valor antes da mudança e index pode ser 0 ou 1, representando o índice do value quando o mesmo for uma tupla.

valueFormat: (value: number) => string

function

Função passada para formatar o valor.