z-uiDesign system
Componentes · z-ui

Label

Rótulo de campo com marcação de obrigatório, texto de opcional e dica em tooltip. É o mesmo rótulo que o FormField usa; sozinho, serve para montar campos fora dele. O texto do rótulo fica sempre visível: a dica completa, nunca substitui.

Estados

required mostra o asterisco em vermelho, escondido do leitor de tela, que já recebe aria-required do campo. optional mostra (opcional) ou o texto que você passar.

Dica

hint coloca um ícone de informação ao lado do rótulo. O ícone é um botão, então a dica também abre pelo teclado.

Tamanho e desabilitado

size="sm" acompanha campos compactos. disabled apaga o texto junto com o campo.

Com controle de escolha

Para checkbox e switch, o rótulo vem depois do controle e clicar nele marca a opção.

Uso

<Label htmlFor="cpf" required hint="Usado no relatório de evidências.">
  CPF
</Label>
<Input id="cpf" tone="data" aria-required />

Props

Aceita também as props do Label do Radix, como htmlFor.

PropTipoPadrãoDescrição
requiredbooleanfalseAsterisco de obrigatório. Marque aria-required no campo.
optionalboolean | ReactNodefalsetrue mostra (opcional); ReactNode troca o texto. Ignorado com required.
hintReactNode—Dica em tooltip, aberta por um botão de informação.
size"sm" | "md""md"Tamanho do texto.
disabledbooleanfalseTexto apagado e cursor de bloqueado.