Pular para o conteúdo

Padrões de UX / Ação e resposta

Prazo que vence

Sessão, Pix e reserva avisam antes, dizem quanto falta e se estendem com um gesto.

/padroes/prazo.mdo mesmo arquivo que a skill entrega ao agente

Todo prazo que a tela impõe se avisa antes e se estende com um gesto (WCAG 2.2.1, nível A).

O problema

A sessão que expira no meio do cadastro leva o cadastro junto. O Pix que vence sem dizer quanto falta deixa a pessoa pagando um QR morto. E o cronômetro de reserva vira pressão, que é a ferramenta de quem vende enganando.

Quando usar

Sempre que a tela tem um relógio que a pessoa não controla: sessão que termina por inatividade, código Pix com validade, reserva de estoque ou de horário, código de verificação por SMS, link de pagamento.

Quando não usar

  • Prazo inventado para apressar não é prazo: é padrão enganoso (padroes-enganosos.md). Oferta que reinicia, "só hoje" que dura a semana, cronômetro no carrinho sem reserva de verdade.
  • Sessão curta sem motivo também não: o prazo existe por segurança, e só onde a segurança pede (banco, prontuário, painel administrativo).

As peças

  • useIdle: diz quando a pessoa parou.
  • AlertDialog: o aviso de sessão, que não se dispensa clicando fora.
  • PixCode com expiresAt, onExpire e onRenew: o Pix que conta quanto falta, vence sozinho e oferece gerar outro. expired é para quando quem sabe que venceu é o servidor.
  • RelativeTime e Text com tabular-nums: o quanto falta, perto do valor.

Comportamento

  • Sessão que expira avisa com pelo menos um minuto de folga, num AlertDialog "Sua sessão termina em 1 minuto", com "Continuar conectado" de primária. Se expirar mesmo assim, o que foi digitado volta depois do novo login: perder um cadastro inteiro para o relógio é o pior desfecho de formulário que existe.
  • Pix com validade mostra quanto falta perto do valor ("Vence em 14:32"): é o expiresAt do PixCode, que faz a conta, anuncia uma vez e no último minuto, e no fim troca o QR pelo vencido com o onRenew. O prazo do Pix é do intermediador e não se estende; renovar é a extensão.
  • Reserva de estoque ou de horário diz quanto tempo segura e o que acontece no fim ("O horário fica reservado até 14h40. Depois disso, ele volta para a agenda"), e nunca é cronômetro de pressão.
  • O relógio para quando a pessoa está trabalhando. Digitar, rolar e clicar contam como presença; o useIdle só dispara depois da pausa.

Texto

  • O aviso diz quanto falta e o que acontece: "Sua sessão termina em 1 minuto. O que você digitou fica guardado."
  • O botão que estende diz o que faz: "Continuar conectado", "Gerar outro código Pix". Nunca "OK".
  • O vencido diz que venceu e o próximo passo: "Este código Pix venceu. Gere outro para pagar."

Acessibilidade

  • O aviso de sessão chega antes do fim, com tempo para quem lê devagar ou usa leitor de tela: um minuto é o piso, e não o alvo.
  • O contador que muda a cada segundo não é região viva: anunciar cada segundo atropela o leitor. Anuncie o aviso uma vez, e de novo no último minuto.
  • Estender é um gesto só, alcançável pelo teclado, com o foco já nele.

No celular e no nativo

No celular a pessoa sai do app para copiar o código Pix no banco e volta: o prazo conta enquanto ela está fora, e a tela, ao voltar, mostra o que sobrou ou o vencido com o renovar. O PixCode mora em @rivocode/ui-native/chart, com o copiar por renderCopy. O AlertDialog nativo é controlado, com onConfirm e labels.

Os blocos que o aplicam

Nenhum bloco do site tem prazo ainda. O Pix inteiro, do QR ao recibo, está em comercio.md.

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