Descrição
Referência de configuração: Descrição
Visão geral
O componente Descrição disponibiliza um editor de texto rico para conteúdo textual mais longo, com suporte a formatação. Ao contrário do campo de texto, que guarda apenas texto simples, o componente de descrição suporta negrito, itálico, títulos, listas, links e outro conteúdo formatado.
Conteúdo de texto rico
Funcionalidades do editor
Nos formulários, o campo de descrição é apresentado como um editor de texto rico numa só caixa: as secções (se houver) como chips, a barra de ferramentas de uma linha, o texto e, com limite de caracteres, o contador. Em só de leitura não há barra.
Quando a barra de ferramentas está ativa, a linha tem, da esquerda para a direita:
- O seletor de estilo: Parágrafo, Título 1, Título 2 e Título 3.
- Negrito, itálico, sublinhado e rasurado.
- Lista, lista numerada e lista de verificação.
- Ligação, citação e bloco de código.
- O menu ⋯, com desfazer, refazer, indentar, desindentar, código em linha, alinhar (esquerda, centro, direita, justificar), subscrito, sobrescrito, cor do texto, cor de fundo, limpar formatação e, se o campo tiver modelos de conteúdo, Inserir modelo. As cores abrem uma grelha de amostras, com Limpar para tirar a cor.
Com o rato, quando a linha não cabe, os grupos passam para o ⋯ por esta ordem: ligação, citação e bloco de código; listas; seletor de estilo; e por fim negrito, itálico, sublinhado e rasurado. Ao toque, a linha desliza na horizontal. O ⋯ nunca sai.
Atalhos
A dica de cada botão e as linhas do ⋯ mostram o atalho (Cmd em vez de Ctrl no macOS):
| Ação | Atalho |
|---|---|
| Negrito, itálico, sublinhado | Ctrl+B, Ctrl+I, Ctrl+U |
| Rasurado | Ctrl+Shift+X |
| Lista, lista numerada, lista de verificação | Ctrl+Shift+L, Ctrl+Shift+O, Ctrl+Shift+C |
| Ligação, citação | Ctrl+K, Ctrl+Shift+B |
| Desfazer, refazer | Ctrl+Z, Ctrl+Y (no macOS, Cmd+Shift+Z para refazer) |
| Indentar, desindentar | Tab, Shift+Tab |
| Código em linha | Ctrl+E |
| Limpar formatação | Ctrl+\ |
Secções
O componente de descrição suporta secções predefinidas: áreas estruturadas dentro do conteúdo, mostradas como chips numa linha por cima da barra. Com Permitir secções do utilizador, um + no fim da linha adiciona secções. Com o botão direito, ou um toque longo, num chip abre-se o menu para renomear a secção ou, havendo mais de uma, apagá-la.
| Definição | Descrição |
|---|---|
| Secções por defeito | Cabeçalhos de secção pré-configurados que aparecem ao criar um novo registo (por exemplo, "Resumo", "Detalhes", "Notas") |
| Permitir secções do utilizador | Quando ativado, os utilizadores podem adicionar os seus próprios cabeçalhos de secção, além dos predefinidos |
Configuração
| Definição | Descrição |
|---|---|
| Placeholder | Texto de indicação apresentado quando o editor está vazio |
| Mostrar barra de ferramentas | Apresenta a barra de ferramentas de formatação (oculte para uma experiência de edição mais limpa e minimalista) |
| Máximo de caracteres | Vazio para sem limite. Com limite, um contador «n / máx.» aparece no fim da caixa e passa à cor de erro quando o excede; é um aviso, não impede de escrever nem de guardar. Com secções, o limite é de cada secção |
| Modelos de conteúdo | Textos prontos que se inserem no cursor com Inserir modelo, no menu ⋯ da barra |
| Valor por defeito | Conteúdo pré-preenchido para novos registos |
Nas tabelas e vistas de lista, a descrição é apresentada como conteúdo HTML formatado, truncado para caber no espaço disponível.