Design systems · Passo 4 · 8 min de leitura
Conteúdo e voz no sistema
As palavras de um componente fazem parte do componente. Como um design system mantém uma voz que não muda e um tom que muda, regras de conteúdo para botões, erros e rótulos, textos guardados com chaves, traduções e limites de tamanho, e quem cuida deles.
As pessoas leem a sua interface antes de olhar para ela. A cor de um botão vem de um token, o espaçamento de outro, e o rótulo vem de quem estava com pressa naquele dia. É assim que um produto acaba com "Enviar", "Mandar", "OK", "Confirmar" e "Pronto" para a mesma ação. Um design system que cuida das cores e não das palavras cuida da parte que as pessoas menos percebem.
O que você vai conseguir fazer depois de ler:
- Explicar voz e tom, e escrever a voz de um sistema em poucas linhas
- Escrever regras de conteúdo para os componentes mais usados
- Guardar textos como tokens: com chaves, traduções e limites de tamanho
- Decidir quem cuida das palavras, e como elas mudam
1. A voz fica, o tom muda
O guia de estilo de conteúdo do Mailchimp tem a versão mais clara: "você tem a mesma voz o tempo todo, mas o seu tom muda" (Mailchimp, Voice and tone). O design system da Atlassian diz o mesmo para as suas interfaces: a voz é "ousada, otimista, prática, com uma piscadela", e o tom "deve mudar conforme a situação em que a pessoa está (por exemplo, recebendo um erro ou concluindo um projeto com sucesso)" (Atlassian, Voice and tone).
O NN/g dá um jeito de descrever o tom com precisão, em quatro dimensões: formal ou casual, sério ou engraçado, respeitoso ou irreverente, entusiasmado ou objetivo (Moran, The Four Dimensions of Tone of Voice, NN/g, 2016).
Sua travessia das 09:40 foi cancelada
Ventos fortes na Ilha de Mara. Sua reserva está garantida: escolha outra travessia ou peça o reembolso total.
Tom: sério, calmo, sem piada
09:40 Kestrel Bay → Ilha de Mara cancelada, clima
142 passageiros para remarcar. Avisos enviados às 08:52.
Tom: curto e factual; a equipe está ocupada
Reserva feita
Até logo em Kestrel Bay. O embarque fecha 15 minutos antes da partida.
Tom: caloroso, um pouco mais leve
Ops! A Mãe Natureza tinha outros planos
Erro WX-409: travessia indisponível.
Uma piada sobre uma viagem estragada, e um código que ninguém consegue usar
A voz do Harbour cabe em três palavras: simples, calma, útil. O tom, nas dimensões do NN/g: sempre respeitoso; casual no app de reservas, mais objetivo no console; nunca engraçado quando algo deu errado. A quarta mensagem da figura não está errada por ser casual. Está errada porque faz piada com uma viagem estragada e entrega às pessoas um código que elas não conseguem usar.
2. Regras de conteúdo dentro dos componentes
Uma voz é geral demais para escrever um botão. Os componentes precisam de regras, escritas na documentação ao lado das props. As do Harbour, para os componentes deste passo:
- Button. Um verbo para a ação, só a primeira letra maiúscula, duas ou três palavras: "Reservar travessia", "Ver bilhete". O GOV.UK Design System pede o mesmo: escrever o texto do botão com só a primeira letra maiúscula, descrevendo a ação que ele faz (GOV.UK, Button). Uma confirmação repete a ação ("Cancelar reserva"), nunca "Sim" ou "OK".
- Text field. Um rótulo que dá nome à coisa ("Sobrenome"), uma dica para o formato, e nenhum placeholder no lugar de nenhum dos dois (veja Componentes acessíveis).
- Mensagem de erro. O que aconteceu e como resolver. O GOV.UK: descreva o que aconteceu e diga como corrigir, em linguagem simples e positiva, e nunca com palavras como "proibido", "ilegal" ou "você esqueceu" (GOV.UK, Error message). Os pares de rótulo e erro deles são um bom modelo: "Quantas horas você trabalha por semana?" vem com "Digite quantas horas você trabalha por semana".
- Selo de status. Uma ou duas palavras, um estado e não uma opinião: "Atrasado 20 min", não "Está um pouquinho atrasado!".
- Estado vazio. O que vai aparecer ali, e a única ação que preenche o espaço. Veja Estados da interface: vazio, carregando, erro, sucesso.
Cada regra deve vir com um faça e um não faça tirados do seu próprio produto. Regras abstratas recebem concordância e são ignoradas.
3. Textos são ativos do sistema
| Chave | Inglês | Português (Brasil) | Máx. | Regra |
|---|---|---|---|---|
ticket. | Show ticket | Ver bilhete | 20 | Começa com verbo; só a primeira letra maiúscula |
ticket. | Delayed {minutes} min | Atrasado {minutes} min | 18 | O número vem dos dados, nunca é digitado |
ticket. | Cancelled | Cancelado | 14 | Nunca aparece sem uma ação ao lado |
ticket. | {time} · {duration} · {date} | {time} · {duration} · {date} | nenhum | Formatado conforme o idioma: "Fri 4 Dec", "sex., 4 de dez." |
ticket. | We couldn't load this ticket | Não conseguimos carregar este bilhete | 40 | O que aconteceu, depois o que fazer |
dialog. | Cancel booking | Cancelar reserva | 20 | Repete a ação; nunca "Sim" ou "OK" |
Se um token é uma decisão de design com nome, um texto com chave é uma decisão de conteúdo com nome. O Harbour guarda as palavras dos seus componentes e padrões assim:
- Uma chave que diz onde e o quê:
ticket.status.delayed, nãostring_284. - As traduções, escritas por pessoas e revisadas no contexto.
- Variáveis, não frases coladas.
Atrasado {minutes} min, com o número vindo dos dados. Colar "Atrasado" + 20 + "min" no código quebra em idiomas com outra ordem de palavras. - Um limite de tamanho com que o layout é testado. Os textos curtos são os que mais crescem na tradução: o W3C cita os números da IBM, de 200 a 300% para textos de até 10 caracteres (W3C Internationalization, Text size in translation). É por isso que Estados e casos-limite testa cada componente com conteúdo longo e traduzido.
- Formatos que vêm do idioma, não digitados: datas, horas, preços. O
Intl.DateTimeFormatdo JavaScript gera "Fri 4 Dec" em inglês britânico (en-GB) e "sex., 4 de dez." em português do Brasil (pt-BR) a partir da mesma data (MDN, Intl.DateTimeFormat).
O ganho é o mesmo dos tokens: mude as palavras uma vez e todos os produtos recebem. Quando o jurídico pede para trocar "reembolso" por "crédito", é uma mudança só, revisada uma vez.
4. Quem cuida das palavras
As palavras de um sistema precisam de alguém responsável, como os componentes. No Harbour:
- Uma pessoa de content design no time do sistema cuida da voz, das regras de conteúdo dos componentes e dos textos compartilhados.
- Os times de produto cuidam das palavras das próprias telas, seguindo as regras, e propõem textos compartilhados novos como qualquer contribuição (Modelos de contribuição).
- Um guia de estilo resolve as coisas pequenas: números, datas, abreviações, maiúsculas. Você não precisa escrever um do zero: o guia de estilo de A a Z do GOV.UK é público e é um bom modelo (GOV.UK, Style guides).
Coloque o conteúdo na mesma revisão do design. Um componente não está pronto para a release enquanto as palavras dele ainda são "Lorem ipsum" ou "Botão".
5. Erros comuns
- Uma voz escrita para o marketing, sem nada para erros ou estados vazios.
- Piadas em erros, atrasos e problemas de pagamento.
- Rótulos de botão que não dizem a ação: "OK", "Enviar", "Sim".
- Textos colados no código, que quebram nas traduções.
- Layouts testados só em inglês.
- Regras de conteúdo que vivem na cabeça de uma pessoa, ou numa apresentação que ninguém abre.
6. Vocabulário
| Termo | Significado |
|---|---|
| Voz | A personalidade das palavras do produto; é a mesma em todo lugar |
| Tom | Como a voz se adapta à situação da pessoa |
| Regra de conteúdo | Uma regra escrita para as palavras de um componente, com exemplos |
| Texto (string) | Um trecho de texto da interface, guardado com uma chave |
| Limite de tamanho | O comprimento máximo para o qual um layout é desenhado e testado |
| Locale | Idioma e região juntos, como pt-BR, que definem os formatos de datas e números |
7. Experimente (sem ferramentas)
- Junte todos os rótulos do botão principal de "seguir em frente" num produto que você conhece.
- Conte as palavras diferentes. Escolha a que melhor diz o que acontece, e escreva uma regra a partir dela.
- Encontre uma mensagem de erro e reescreva como o que aconteceu mais como resolver.
Perguntas para refletir: Se a voz do seu produto fosse três palavras, quais seriam? Que tela as quebra hoje?
8. Se você já pratica
- Acrescente uma seção "Conteúdo" a toda página de documentação de componente: regras, faça e não faça, limites de tamanho.
- Tire os textos compartilhados do código e coloque num arquivo com chaves, com acesso para quem escreve.
- Teste os layouts com uma versão pseudolocalizada (texto mais longo e com acentos) antes de as traduções reais chegarem.
- Inclua uma pessoa de content design nas revisões de componente desde o primeiro rascunho.
Checklist
Para saber mais
- Mailchimp, Voice and tone · Atlassian, Voice and tone
- Kate Moran, The Four Dimensions of Tone of Voice (NN/g, 2016)
- GOV.UK: Button · Error message · Style guides
- W3C, Text size in translation · MDN, Intl.DateTimeFormat
Livros, cursos e vídeos para ir mais fundo
- Redação estratégica para UXTorrey PodmajerskyLivro · Novatec, 2019 · edição brasileira de "Strategic Writing for UX" (Amazon)
- Content DesignSarah RichardsLivro · Content Design London, 2017 (Amazon)
Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.
Relacionadas
De componentes a padrões · Ícones e ilustração no sistema · Conteúdo primeiro · Componentes acessíveis · Estados e casos-limite · Estados da interface: vazio, carregando, erro, sucesso · Modelos de contribuição