Pular para o conteúdo
Formulário

Slider

/componentes/slider.mdmarkdown cru, para quem lê com agent em vez de olho

Com rótulo

Desconto25

Faixa

Faixa de valor20 – 60
Importar
import { Slider } from '@rivocode/ui'

Quando usar

Escolha de valor numa faixa: desconto, prazo, tolerância.

Só vale quando o número exato não importa. Se importa, o NumberField diz mais e não pede pontaria: arrastar um pino até 37 é trabalho, digitar 37 não.

<Slider defaultValue={25} max={50} label="Desconto" showValue />

O label é o nome que o leitor de tela lê no pino, e não só o texto acima dele: um pino sem rótulo visível é que precisa de thumbLabel.

format escreve o número do showValue e o que o leitor de tela anuncia: o nome de um formatador da casa, ou uma função sua para a unidade que só esta tela tem.

<Slider defaultValue={30} max={90} label="Prazo" showValue format={(dias) => `${dias} dias`} />

Com dois valores, vira faixa de dois pinos, e cada pino precisa do próprio nome, senão o leitor de tela anuncia dois controles iguais:

<Slider
  defaultValue={[20, 60]}
  label="Faixa de valor"
  showValue
  thumbLabel={['Valor mínimo', 'Valor máximo']}
/>

Quando não usar

Quando o número exato importa, use NumberField: digitar 37 é mais rápido do que mirar 37. E dinheiro é CurrencyInput, nunca uma faixa arrastável.

Nota em estrelas é Rating, que mostra a escala inteira de uma vez. E quanto de uma capacidade está em uso, que se lê e não se ajusta, é o Meter.

No React Native

Traduz: o @rivocode/ui-native exporta Slider - anda por gesto e responde às ações do leitor de tela; um valor só, label obrigatório, e showValue e format como no web; classNames com as seis partes do web. A API não é a mesma do web (no nativo tudo é controlado), e a tabela de paridade diz o que muda peça a peça.

API

PropTipoPadrão
classNames0.5.0

Classe por parte: `label`, `value`, `control`, `track`, `indicator`, `thumb`.

Partial<Record<"control" | "indicator" | "label" | "thumb" | "track" | "value", string>>sem padrão
defaultValue0.4.0

O valor inicial do controle deslizante, no modo não controlado.

number | readonly number[]sem padrão
disabled0.4.0

Se o controle deslizante ignora a interação do usuário.

booleanfalse
form0.4.0

Identifica o formulário dono dos campos do controle deslizante.

stringsem padrão
format0.4.0

Como o numero e escrito: nome de formatador da casa ou funcao propria, o mesmo vocabulario do eixo do grafico.

Formatsem padrão
label0.4.0

Texto acima do controle, e o nome que o leitor de tela le no pino.

ReactNodesem padrão
largeStep0.4.0

O passo do controle deslizante com Page Up, Page Down ou Shift com as setas.

number10
locale0.4.0

O idioma que o `Intl.NumberFormat` usa para formatar o valor.

LocalesArgumentsem padrão
max0.4.0

O maior valor do controle deslizante.

number100
min0.4.0

O menor valor do controle deslizante.

number0
minStepsBetweenValues0.4.0

O mínimo de passos entre os dois valores de uma faixa.

number0
name0.4.0

Identifica o campo quando o formulário é enviado.

stringsem padrão
numberFormat0.5.0

As opcoes do `Intl.NumberFormat`, para quem precisa delas.

NumberFormatOptionssem padrão
onValueChange0.4.0

Chamado quando o valor do controle deslizante muda.

((value: number | readonly number[], eventDetails: SliderRootChangeEventDetails) => void)sem padrão
onValueCommitted0.4.0

Chamado quando a mudança de valor é confirmada.

((value: number | readonly number[], eventDetails: SliderRootCommitEventDetails) => void)sem padrão
orientation0.4.0

A orientação da peça.

Orientation"horizontal"
render0.4.0

Troca o elemento HTML da peça por outra tag, ou a compõe com outro componente.

ComponentRenderFn<HTMLProps, SliderRootState> | ReactElement<unknown, string | JSXElementConstructor<any>>sem padrão
showValue0.4.0

Mostra o valor ao lado do rotulo.

booleansem padrão
step0.4.0

O passo do controle deslizante.

number1
thumbAlignment0.4.0

Como o polegar se alinha ao `Slider.Control` no `min` ou no `max`: `center` põe o centro na borda; `edge` põe a borda do polegar na borda do controle; `edge-client-only` é o `edge` desenhado só depois da hidratação, com pacote menor.

"center""edge""edge-client-only""center"
thumbCollisionBehavior0.4.0

O que os polegares fazem quando se encontram durante o arraste.

"none""push""swap""push"
thumbLabel0.4.0

O que o leitor de tela chama o pino, no lugar do `label`.

string | string[]sem padrão
value0.4.0

O valor do controle deslizante.

number | readonly number[]sem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.