Pular para o conteúdo
Dados

Timeline

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

Trilha de uma entrega

  1. Destaque: Pedido despachado

    · Ana Prado

  2. Sucesso: Recebido no centro de distribuição

    Código de rastreio BR4821
  3. Erro: Tentativa de entrega falhou

    · Carlos Nunes

    Motivo: ninguém atendeu no endereço
  4. Pendente: Nova tentativa agendada

Importar
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.

@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.