Timeline
Trilha de uma entrega
Destaque: Pedido despachado
· Ana Prado
Sucesso: Recebido no centro de distribuição
Código de rastreio BR4821Erro: Tentativa de entrega falhou
· Carlos Nunes
Motivo: ninguém atendeu no endereçoPendente: Nova tentativa agendada
import { Timeline } from '@rivocode/ui'Quando usar
O que aconteceu com uma coisa, em ordem.
Um pedido olha para trás (pago, separado, despachado, entregue, devolvido) com carimbo de tempo e autor em cada ponto. Trilha de auditoria tem a mesma forma: o que mudou, quando e por quem.
Sai como <ol> porque a ordem é o dado. Um leitor de tela que anuncia "lista de
5 itens" na ordem certa já entregou metade do que a linha desenha.
O tom é por item, de propósito: numa entrega, a linha da tentativa que falhou é
vermelha e as outras não, e é essa linha que a pessoa procura quando abre a trilha.
pending deixa o marcador vazado: preencher o marcador de um evento futuro
faz a linha prometer que ele já ocorreu, que é o erro que uma trilha de
auditoria não pode cometer.
Como cor e marcador vazado não chegam a quem ouve, o título leva antes dele um
texto só para o leitor de tela: "Pendente", e uma palavra por tom ("Sucesso",
"Atenção", "Erro", "Destaque"; o neutral não diz nada). O que cada tom quer
dizer é do produto, então labels troca a palavra: labels={{ tone: { danger: "Falhou" } }}, e texto vazio cala.
Movimento
Cada TimelineItem entra esmaecendo e subindo 4px (animate-enter, --rc-duration-base), sem escalonar: na montagem a trilha inteira entra de uma vez, e depois só o evento novo entra. Com "reduzir movimento", aparece parada.
Quando não usar
Para um formulário longo em etapas, use Steps. O Steps é assistente: olha
para a frente, sabe quantos passos faltam e só deixa voltar. A Timeline olha
para trás e ninguém "avança" nela. Trocar uma pela outra faz o controle
prometer o que ele não faz, o mesmo argumento que separa Progress de Meter.
As partes
TimelineItem é um ponto: title, at, by, tone, pending, e conteúdo
livre como filho. O at costuma receber um RelativeTime.
No React Native
Traduz, com a lista por items: cada evento leva title, at, by, description, tone e pending, e a composição do TimelineItem não atravessa (a mesma regra do RadioGroup e do Select). O carimbo é texto, e não um RelativeTime: cada evento é uma parada só do leitor de tela e o rótulo dela é montado a partir desse texto, então um relógio vivo lá dentro continuaria andando na tela enquanto o rótulo ficaria preso na hora em que montou. E trilha de auditoria não pode dizer duas horas diferentes. Para o carimbo, formatDate. A ordem, que o <ol> do web entrega de graça, vai escrita: não existe papel de item de lista no React Native, então cada evento anuncia "3 de 5: Pedido enviado, 12/03 às 14:22, por Ana Duarte", uma frase com o que mudou, quando e por quem, em vez de três paradas de VoiceOver que não dizem o assunto. E nada é tocável: uma trilha se lê, e o marcador de 9px nunca seria alvo de dedo. Quem quer abrir o detalhe de um evento põe um Item com onPress.
Os textos que o leitor de tela ouve saem de labels: pending ("ainda não aconteceu"), position (o "3 de 5") e by (o "por Ana").
API
Sem prop própria: repassa ao elemento de baixo o que você mandar.