Editable
Corrigir sem sair da tela
- Paciente
- Editar paciente
- Observação
- Editar observação
import { Editable } from '@rivocode/ui'Quando usar
Edição no lugar: o texto vira campo ao ser clicado, e volta a ser texto ao ser confirmado.
É o gesto que separa painel de leitura de painel de operação. Corrigir o nome de um cliente sem abrir uma tela de edição, sem perder a posição na lista e sem esperar duas navegações é a diferença entre a pessoa corrigir e a pessoa deixar errado.
Duas decisões que a peça toma, e que são a razão de ela existir. O Escape desfaz: sair pela lateral é o gesto de quem se arrependeu, e salvar ali transforma um clique errado numa edição que ninguém pediu. Sair do campo salva: é o oposto do Escape de propósito, porque quem clicou fora seguiu adiante, e exigir um Enter depois disso perde o que foi escrito sem avisar.
A troca entre texto e campo esmaece, curta, no tempo --rc-duration-base: o
salto seco fazia a linha parecer que piscou. Na primeira pintura não há fade, e
com "reduzir movimento" o token vai a zero e a troca volta a ser seca.
Fechado, o texto é um button. Quem navega pelo teclado precisa saber que
aquilo abre alguma coisa, e um div com onClick não diz isso a ninguém.
Ele se mostra editável. Sob o ponteiro e no foco do teclado, o fundo vira
accent-subtle e um lápis aparece ao lado do texto; no toque, onde não há
ponteiro, o lápis fica sempre à vista. O lápis é decorativo: para o leitor de
tela, o nome do botão continua sendo o texto, e a dica "Editar Cliente" chega
como descrição, montada do label (labels.edit troca).
Como título
level faz da peça um título, de h1 a h3: o texto fechado e o campo aberto
ficam dentro do <hN>, na letra de título, e quem navega por seção continua
achando o título. O nome do título é o próprio texto. size troca o corpo na
escala do Heading sem trocar o nível.
<Editable level={1} label="Nome do contrato" value={contract.name} onValueChange={rename} />
Quem guarda o valor
Guarda o próprio quando recebe só defaultValue, e obedece ao de fora quando
recebe value, o mesmo par das outras peças de formulário. Controle quando o
valor precisa voltar do servidor depois de salvo; deixe solto quando a correção
só vale nesta tela.
<Editable defaultValue="Marina Toledo" label="Paciente" onValueChange={save} />
O label continua obrigatório: aberto, a peça é um <input> sem rótulo
visível, e sem ele o campo fica sem nome.
Quando não usar
Quando a mudança precisa de confirmação explícita: valor, preço, qualquer
campo que o servidor valida e pode recusar. Ali um Dialog com Salvar e
Cancelar diz o que está em jogo; a edição no lugar promete que é barato desfazer.
No React Native
Traduz, com os dois gestos trocados. E os dois eram a peça inteira no web, então vale ler antes de portar a tela.
Quem abre é o toque longo, e não o toque. É o gesto que o sistema já usa para agir sobre um texto, e a escolha é defensiva: num painel de leitura o dedo encosta em tudo enquanto rola, e com o toque curto abrindo o campo o teclado subia sozinho a cada esbarrão. Para quem usa leitor de tela o gesto não existe, então a peça declara também uma ação de acessibilidade longpress chamada "Editar", que aparece no rotor.
Sair do campo não salva. No web, clicar fora confirma; aqui não há clicar fora: há o teclado que se esconde, e o próprio Cancelar tira o foco do campo antes de rodar, então um blur que salvasse salvaria o rascunho no caminho de cancelá-lo. Nada sai daqui sem confirmação explícita (o botão de retorno do teclado) e nada se perde sem o Cancelar, que é visível ao lado do campo porque sem Escape não existe saída invisível.
O resto é o contrato de sempre: value e onValueChange obrigatórios, sem defaultValue, e label obrigatório. Fechada, a peça anuncia label e valor juntos, porque "Nome do cliente" sozinho manda a pessoa abrir a edição só para descobrir o que há lá dentro.
As partes vestem pelo mesmo classNames do web: preview, a área que se segura para editar, e input, o campo aberto. Aqui há uma a mais, text, o Text do valor lido, porque o Pressable não passa classe de texto para dentro.
Serve de título. heading veste a família e o peso de título do provider e sobe o corpo para xl; size escolhe o degrau na escala do Heading, de sm a display, e o campo aberto abre no mesmo tamanho. O lápis que o web mostra sob o ponteiro não atravessa: no toque não há ponteiro.
API
| Prop | Tipo | Padrão |
|---|---|---|
labelobrigatória0.5.0O que o leitor de tela chama o campo enquanto ele esta aberto. | string | sem padrão |
classNames0.5.0Classe por parte: `preview`, `input`, `icon` (o lapis que aparece no ponteiro e no foco). | Partial<Record<"icon" | "input" | "preview", string>> | sem padrão |
defaultValueO texto do primeiro desenho, quando a peca guarda o proprio valor. | string | "" |
disabled0.5.0 | boolean | sem padrão |
labelsOs textos da peca: `edit(label)` e a dica que o leitor de tela ouve no texto fechado. | Partial<EditableLabels> | sem padrão |
levelFaz da peca um titulo, de `h1` a `h3`: o texto e o campo aberto ficam dentro do `<hN>`, na letra de titulo, e o leitor de tela continua achando o titulo pela navegacao de secao. | 123 | sem padrão |
onValueChange0.5.0Avisado no Enter e ao sair do campo, e nunca no Escape. | ((value: string) => void) | sem padrão |
placeholder0.5.0O que aparece quando o valor esta vazio. | string | "—" |
sizeO corpo do titulo, na escala do `Heading`. | HeadingSize | sem padrão |
value0.5.0O texto de agora, quando quem usa guarda o valor. | string | sem padrão |
Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.