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.
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.PixCodecomexpiresAt,onExpireeonRenew: o Pix que conta quanto falta, vence sozinho e oferece gerar outro.expiredé para quando quem sabe que venceu é o servidor.RelativeTimeeTextcomtabular-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
expiresAtdoPixCode, que faz a conta, anuncia uma vez e no último minuto, e no fim troca o QR pelo vencido com oonRenew. 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
useIdlesó 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.