Pular para o conteúdo
Formulário

PasswordInput

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

Entrar

Importar
import { PasswordInput } from '@rivocode/ui'

Quando usar

Campo de senha com o olho que revela.

Existe como peça porque todo projeto reconstrói este par, e reconstrói com o mesmo defeito: o botão dizendo o estado em vez da ação. "Senha visível" não diz o que acontece ao clicar, e quem navega por leitor de tela decide pelo verbo. Aqui o nome do botão é sempre a ação: "Mostrar senha", "Esconder senha".

Revelar é um gesto momentâneo: sair do campo esconde de novo. Deixar a senha na tela depois que a pessoa foi para outro lugar é o que faz alguém ser lido por cima do ombro numa mesa compartilhada.

Vestir por parte

O className veste o campo, e não a moldura. É a única peça do catálogo em que a raiz não é o alvo dele, e mudar isso agora trocaria em silêncio a largura de toda tela de login que já existe. Então a moldura ganhou nome próprio:

<PasswordInput
  aria-label="Senha"
  classNames={{ wrapper: 'w-72', input: 'font-mono', action: 'text-fg-muted' }}
/>

Os dois nomes que o leitor de tela ouve no botão entram por labels, e cada um tem o próprio padrão. Trocar só um não apaga o outro:

<PasswordInput aria-label="Senha" labels={{ show: 'Revelar a senha' }} />

Quando não usar

Para código de verificação de seis dígitos, use OTPField. Ele separa as casas, aceita colar o código inteiro e não esconde nada, porque o código é para ser lido em voz alta do celular.

No React Native

Traduz: o @rivocode/ui-native exporta PasswordInput - o botão troca de nome com o estado (labels.show/labels.hide), e sair do campo esconde de novo; classNames com wrapper, input e action. 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

PropTipo
classNames

Classe por parte: `wrapper`, `input`, `action`.

Partial<Record<"action" | "input" | "wrapper", string>>
defaultValue0.5.0stringnumberreadonly string[]
labels0.5.0

O que o leitor de tela ouve no botao, antes e depois de revelar.

{ show?: string | undefined; hide?: string | undefined; }
onValueChange0.5.0

Chamado quando o `value` muda.

((value: string, eventDetails: { reason: "none"; event: Event; cancel: () => void; allowPropagation: () => void; isCanceled: boolean; isPropagationAllowed: boolean; trigger: Element | undefined; }) => void)
render0.5.0

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

ComponentRenderFn<HTMLProps, FieldControlState> | ReactElement<unknown, string | JSXElementConstructor<any>>
size0.5.0"lg""md""sm"

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.