Slider
Com rótulo
Faixa
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
| Prop | Tipo | Padrão |
|---|---|---|
classNames0.5.0Classe por parte: `label`, `value`, `control`, `track`, `indicator`, `thumb`. | Partial<Record<"control" | "indicator" | "label" | "thumb" | "track" | "value", string>> | sem padrão |
defaultValue0.4.0O valor inicial do controle deslizante, no modo não controlado. | number | readonly number[] | sem padrão |
disabled0.4.0Se o controle deslizante ignora a interação do usuário. | boolean | false |
form0.4.0Identifica o formulário dono dos campos do controle deslizante. | string | sem padrão |
format0.4.0Como o numero e escrito: nome de formatador da casa ou funcao propria, o mesmo vocabulario do eixo do grafico. | Format | sem padrão |
label0.4.0Texto acima do controle, e o nome que o leitor de tela le no pino. | ReactNode | sem padrão |
largeStep0.4.0O passo do controle deslizante com Page Up, Page Down ou Shift com as setas. | number | 10 |
locale0.4.0O idioma que o `Intl.NumberFormat` usa para formatar o valor. | LocalesArgument | sem padrão |
max0.4.0O maior valor do controle deslizante. | number | 100 |
min0.4.0O menor valor do controle deslizante. | number | 0 |
minStepsBetweenValues0.4.0O mínimo de passos entre os dois valores de uma faixa. | number | 0 |
name0.4.0Identifica o campo quando o formulário é enviado. | string | sem padrão |
numberFormat0.5.0As opcoes do `Intl.NumberFormat`, para quem precisa delas. | NumberFormatOptions | sem padrão |
onValueChange0.4.0Chamado quando o valor do controle deslizante muda. | ((value: number | readonly number[], eventDetails: SliderRootChangeEventDetails) => void) | sem padrão |
onValueCommitted0.4.0Chamado quando a mudança de valor é confirmada. | ((value: number | readonly number[], eventDetails: SliderRootCommitEventDetails) => void) | sem padrão |
orientation0.4.0A orientação da peça. | Orientation | "horizontal" |
render0.4.0Troca 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.0Mostra o valor ao lado do rotulo. | boolean | sem padrão |
step0.4.0O passo do controle deslizante. | number | 1 |
thumbAlignment0.4.0Como 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.0O que os polegares fazem quando se encontram durante o arraste. | "none""push""swap" | "push" |
thumbLabel0.4.0O que o leitor de tela chama o pino, no lugar do `label`. | string | string[] | sem padrão |
value0.4.0O 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.