Pular para o conteúdo
Feedback

Indicator

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

Avisos não lidos

7 avisos não lidos150 avisos não lidosHá algo novo
Importar
import { Indicator } from '@rivocode/ui'

Quando usar

A contagem por cima de outra coisa: avisos no sino, itens na aba, mensagens no menu.

Existe como peça porque a alternativa é cada tela posicionar um Badge com absolute na mão, e as cinco telas acabam com cinco deslocamentos diferentes, todas com o mesmo defeito: a contagem existindo só para quem vê. Aqui o número é escondido do leitor de tela e o label inteiro entra no lugar dele, porque "7" não diz o que são sete.

Zero não desenha nada. Uma pastilha com "0" chama atenção para dizer que não há nada, que é o contrário do trabalho dela.

Acima de max sai "99+", em vez de a pastilha esticar e empurrar o que está ao lado. Com dot, sai só o ponto, para "tem algo novo aqui", quando o número não importa.

A pastilha fica por cima do filho, e não ao lado: ela não reserva espaço. Isso serve para alvo pequeno (o botão do sino, o item da barra, o avatar), e sempre cobre texto quando o filho é largo. Acima de 48px de largura, que é o maior alvo legítimo do catálogo (Avatar grande e controle lg na densidade confortável medem exatamente isso), a peça avisa no console em desenvolvimento. Para marcar uma linha inteira, ponha a contagem ao lado, com um Badge.

Movimento

A pastilha cresce de 60% esmaecendo quando aparece (animate-pop, --rc-duration-fast): ela avisa que chegou algo, e o movimento curto puxa o olho sem virar alarme. A troca de número não repete a entrada.

Quando não usar

Para marcar uma linha inteira, ou o estado de um registro (pago, em análise), use Badge ao lado: a pastilha daqui fica por cima do filho e cobre o texto quando ele é largo. O número de painel, com variação e tendência, é Stat.

O sino com a lista de notificações é NotificationCenter, que já diz quantas a pessoa não leu: não ponha um Indicator à mão por cima dele.

No React Native

Traduz, e o que muda é quem carrega o nome acessível. No web o número é escondido do leitor e um texto só para ele entra ao lado; no nativo a pastilha inteira é UM elemento de acessibilidade, e o label (aqui obrigatório) é o que ele anuncia. O leitor lê o filho ("Notificações, botão") e a pastilha em seguida ("3 notificações"), e nunca um "3" solto entre os dois. Embrulhar filho e pastilha num elemento só resolveria a leitura e quebraria o toque, porque o botão de dentro deixaria de ser alcançável. O anel que separa a pastilha do que está embaixo vira borda da cor do fundo: ring não existe no React Native, e borda ali ocupa por dentro da caixa.

A pastilha se veste por classNames.badge, o mesmo nome do web.

API

PropTipoPadrão
classNames0.5.0

Classe por parte: `badge`.

Partial<Record<"badge", string>>sem padrão
count0.5.0

Quantos.

numbersem padrão
dot0.5.0

Sem contagem: so o ponto, para "tem algo novo aqui".

booleansem padrão
label0.5.0

O que o leitor de tela ouve.

stringsem padrão
max0.5.0

O teto: acima dele sai "99+", em vez de a pastilha esticar.

number99

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.