Pular para o conteúdo

DocsFormulárioSlider

Formulário

Slider

Escolha um valor numa escala com marcas. Arraste, clique ou use o teclado, e ele encaixa na marca.

data-u="slider"

Exemplo

Instalação

Slider vem no pacote completo, em unslop.css e unslop.js:

curl -fsSL unslop.leallabs.dev/i | sh

Um bloco pronto que usa slider:

curl -fsSL unslop.leallabs.dev/i | sh -s add wall-models

Sem build O add por nome serve pra gráficos e blocos. Componentes com JS moram em unslop.js, que monta sozinho todo data-u da página.

Props

Vão em data-u-props, como JSON.

PropTipoPadrãoO que faz
minnumber0Menor valor.
maxnumber4Maior valor.
stepnumber1Passo entre as marcas. Cada passo ganha uma marca na trilha.
valuenumberminValor inicial.
labelstringsem padrãoNome da trilha (aria-label).
leftstringsem padrãoTexto da ponta esquerda.
rightstringsem padrãoTexto da ponta direita.
textsarraysem padrãoUm texto por posição. Vira o aria-valuetext e vai no evento.

Acessibilidade e teclado

Estado e papéis

OndeAtributoO que diz
trilharole="slider", tabindex="0"A trilha recebe o foco.
trilhaaria-valuemin, aria-valuemax, aria-valuenowLimites e valor atual.
trilhaaria-valuetextO texto da posição (de texts) ou o número.

Teclado

TeclaFaz
Seta para a direita ou para cimasobe um passo
Seta para a esquerda ou para baixodesce um passo
Homevai pro mínimo
Endvai pro máximo

Eventos e API

EventodetailQuando
u:change{ value, text }Quando o valor muda, por arrasto, clique ou teclado.

Todo evento sobe pela página (bubbles). Escute no próprio elemento: el.addEventListener("u:change", (e) => e.detail).

el._u.value lê o valor atual.

Digite pra buscar. Setas escolhem, Enter abre.