Pular para o conteúdo
Formulário

Editable

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

Corrigir sem sair da tela

Paciente
Observação
Importar
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

PropTipoPadrão
labelobrigatória0.5.0

O que o leitor de tela chama o campo enquanto ele esta aberto.

stringsem padrão
classNames0.5.0

Classe por parte: `preview`, `input`, `icon` (o lapis que aparece no ponteiro e no foco).

Partial<Record<"icon" | "input" | "preview", string>>sem padrão
defaultValue

O texto do primeiro desenho, quando a peca guarda o proprio valor.

string""
disabled0.5.0booleansem padrão
labels

Os textos da peca: `edit(label)` e a dica que o leitor de tela ouve no texto fechado.

Partial<EditableLabels>sem padrão
level

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

123sem padrão
onValueChange0.5.0

Avisado no Enter e ao sair do campo, e nunca no Escape.

((value: string) => void)sem padrão
placeholder0.5.0

O que aparece quando o valor esta vazio.

string"—"
size

O corpo do titulo, na escala do `Heading`.

HeadingSizesem padrão
value0.5.0

O texto de agora, quando quem usa guarda o valor.

stringsem padrão

Além destas, a peça aceita className, style, id e children, repassados ao elemento de baixo.

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