Navegar componentes
← ComponentesUm pequeno ponto colorido que comunica status como presença online/offline ou níveis de severidade. Suporta cinco variantes semânticas e animação pulse opcional. Sempre combine com um label de texto visível, pois cor sozinha não deve carregar significado.
StatusDot
MiscExemploExemplos
Área interativa
variant
isPulsing
Boas práticas
- Faça: Sempre combine com um label de texto visível para que o status não seja comunicado apenas por cor.
- Faça: Forneça uma prop `label` descritiva para acessibilidade com screen readers.
- Evite: Use a animação pulse para fins puramente decorativos; reserve para estados que exigem atenção imediata.
- Evite: Confie apenas na cor para comunicar status; sempre inclua texto.
Props
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
variant * | 'success' | 'warning' | 'error' | 'accent' | 'neutral' | — | Variante de cor semântica. |
label * | string | — | Label acessível exposto via aria-label. |
isPulsing | boolean | false | Habilita animação pulse; respeita prefers-reduced-motion: reduce. |
tooltip | string | — | Texto de tooltip exibido no hover para explicar o significado do status. |
xstyle | StyleXStyles | — | Estilos StyleX para customização de layout (margens, posicionamento, dimensionamento). Deve ser um valor stylex.create(), não um objeto de estilo inline como style={{}}. |