O Componente principal de texto é um componente de edição e composição de rich text que apresenta edição no local.
O componente de texto oferece um editor de rich text robusto que permite a edição fácil de texto em um editor simplificado e em linha, bem como um formato de tela cheia.
A caixa de diálogo de edição apresenta edição em linha com opções limitadas com funcionalidade total disponível na caixa de diálogo de edição em tela cheia. Usando a caixa de diálogo de design, opções de formatação de texto, como cabeçalhos, caracteres especiais e estilos de parágrafo, podem ser configuradas para o modelo para o autor de conteúdo.
A versão atual do Componente de texto é a v2, que foi introduzida com a versão 2.0.0 dos Componentes principais em janeiro de 2018, e é descrita neste documento.
A tabela a seguir detalha todas as versões compatíveis do componente, as versões de AEM com as quais as versões do componente são compatíveis e vincula à documentação das versões anteriores.
Versão do componente | AEM 6.4 | AEM 6.5 | AEM as a Cloud Service |
---|---|---|---|
v2 | Compatível | Compatível | Compatível |
v1 | Compatível | Compatível | - |
Para obter mais informações sobre versões e versões dos Componentes principais, consulte o documento Versões dos componentes principais.
Para experimentar o Componente de texto, bem como ver exemplos de suas opções de configuração, bem como a saída HTML e JSON, visite a Biblioteca de componentes.
A documentação técnica mais recente sobre o Componente de texto pode ser encontrada no GitHub.
Mais detalhes sobre o desenvolvimento dos Componentes principais podem ser encontrados na documentação do desenvolvedor dos Componentes principais.
O componente de texto dos componentes principais aproveita o editor de rich text (RTE) do AEM. O RTE fornece aos autores de conteúdo uma ampla variedade de funcionalidades para editar seu conteúdo de texto. O RTE é muito flexível em sua configuração e oferece várias opções. Mais detalhes sobre como o RTE pode ser configurado podem ser encontrados nos artigos Configurar o Editor de Rich Text e Configurar os plug-ins do Editor de Rich Text.
O restante deste artigo demonstra a configuração padrão do Componente de texto dos componentes principais com a configuração predefinida do RTE.
Somente as opções ativadas pelas configurações da interface do usuário do RTE estão disponíveis no Componente de texto.
A caixa de diálogo de edição oferece as ferramentas padrão de formatação de rich text que um usuário esperaria compor o texto.
Usado para aplicar a formatação em negrito ao texto selecionado ou para formatar o texto em negrito inserido após o cursor.
Ctrl+ Bcan pode ser usado como atalho de teclado.
Usado para aplicar a formatação em itálico ao texto selecionado ou colocar o texto em itálico inserido após o cursor.
Ctrl+ Pode ser usado como um atalho de teclado.
Usado para aplicar a formatação sublinhada ao texto selecionado ou ao texto sublinhado inserido após o cursor.
Ctrl+ Usa pode ser usado como um atalho de teclado.
Usado para formatar o texto selecionado ou o texto inserido após o cursor como subscrito.
Usado para formatar o texto selecionado ou o texto inserido após o cursor como sobrescrito.
Cola qualquer texto copiado como texto sem formatação.
Ao selecionar essa opção, uma janela é aberta, onde o texto pode ser colado como texto sem formatação como visualização antes de ser inserido no texto. Aceite tocando ou clicando na marca de seleção, cancele tocando ou clicando no x.
Ao selecionar essa opção, uma janela é aberta, onde o texto pode ser colado, mantendo sua formatação como visualização, antes de ser inserido no texto. Aceite tocando ou clicando na marca de seleção, cancele tocando ou clicando no x.
Use essa opção para converter o texto selecionado em um hiperlink ou modificar um link já definido. Essa opção só estará ativa quando o texto já estiver selecionado e abrirá uma janela com opções adicionais para definir o link.
Insira o caminho
Inserir texto descritivo alternativo para o link
Selecionar comportamento do link
Toque ou clique na marca de seleção para aplicar o link ou o x para cancelar.
Use esta opção para remover um link já aplicado ao texto selecionado. Essa opção só estará ativa quando um link já estiver selecionado.
Use essa opção para pesquisar a ocorrência de uma string de texto especificada no texto. Selecionar essa opção abre uma janela para especificar as opções de pesquisa.
Insira o texto para o qual deseja pesquisar e toque ou clique em Localizar para iniciar a pesquisa. Toque ou clique no x para cancelar.
Se desejar fazer uma correspondência exata de acordo com o caso, selecione a opção Match Case antes de iniciar a pesquisa.
Se uma correspondência for encontrada, ela será realçada e a caixa de diálogo de pesquisa ficará esmaecida. Toque ou clique no botão Find novamente na caixa de diálogo esmaecida para procurar a próxima ocorrência.
Se nenhuma ocorrência adicional for encontrada, uma mensagem será exibida e a pesquisa será reiniciada a partir do início do texto.
Use essa opção para pesquisar o texto de ocorrências de uma string de texto especificada e substituir as correspondências por outra string. Selecionar essa opção abre uma janela para especificar as opções de pesquisa e substituição.
Insira o texto que deseja pesquisar, bem como o texto com o qual ele deve ser substituído.
Se uma correspondência for encontrada, ela será realçada e a caixa de diálogo de pesquisa ficará esmaecida. Clique no botão Find novamente na caixa de diálogo esmaecida para procurar a próxima ocorrência ou selecione o botão Replace para substituir o texto destacado e correspondente. Observe que o botão Substituir só estará ativo depois que uma correspondência for feita.
A caixa de diálogo localizar e substituir se torna transparente quando a localização é clicada e se torna opaca ao clicar em substituir. Isso permite que o autor revise o texto que será substituído.
Ao usar a funcionalidade de substituição, a string de substituição a ser substituída deve ser inserida ao mesmo tempo que a string de localização. No entanto, você ainda pode clicar em localizar para procurar a cadeia de caracteres antes de substituí-la. Se a string de substituição for inserida após clicar em localizar, a pesquisa será redefinida para o início do texto.
Usado para alinhar o texto à margem esquerda.
Usada para centralizar o texto.
Usado para alinhar o texto à margem direita.
Usado para formatar o texto selecionado como uma lista com marcadores ou iniciar a inserção de uma lista com marcadores após o cursor.
Para encerrar uma lista com marcadores, toque ou clique novamente no botão Marcador ou insira duas devoluções de carro.
Usado para formatar o texto selecionado como uma lista numerada ou iniciar a inserção de uma lista numerada após o cursor.
Para terminar uma lista numerada, toque ou clique novamente no botão Numerado ou insira dois retornos de carro.
Usado para diminuir o nível de recuo do texto selecionado ou do texto inserido após o cursor.
Ativa somente se o texto ou a posição do cursor selecionado já estiver recuada.
Usado para aumentar o nível de recuo do texto selecionado ou do texto inserido após o cursor.
Usado para inserir uma tabela no texto. Selecionar essa opção abre uma janela para especificar os detalhes da tabela.
Usado para verificar a ortografia do conteúdo do texto. Possíveis erros ortográficos são sublinhados com linhas vermelhas quebradas.
Mais detalhes sobre verificação ortográfica e personalização de dicionários de verificação ortográfica podem ser encontrados no documento Configurar os plug-ins do editor de rich text.
Usado para inserir caracteres especiais no texto. Selecionar essa opção abre uma janela onde os caracteres disponíveis são exibidos.
Toque ou clique no caractere desejado para inseri-lo no texto após o cursor. Vários caracteres podem ser inseridos. Toque ou clique no x para fechar a janela de seleção.
Usado para exibir e modificar a fonte HTML do texto.
Toque ou clique no ícone Source Edit para alterar o conteúdo do texto da exibição formatada para exibir o HTML bruto. Nesse modo, todas as outras opções de formatação são desativadas. Toque ou clique no ícone Editar fonte novamente para retornar à exibição formatada.
Como sempre o caso com acesso a HTML bruto, o cuidado deve ser exercido ao usar a opção Source Edit!
O HTML inserido por Source Edit é verificado em busca de riscos XSS e os scripts inseridos são removidos e não aparecerão na página resultante. No entanto, o HTML mal formado inserido em Source Edit pode quebrar o modelo da página, resultando em formatação inesperada ou inutilizando a página resultante.
Como o HTML inserido por Source Edit é verificado em busca de riscos XSS e qualquer script e remove automaticamente os encontrados, o conteúdo real persistente pode variar do que foi inserido em Source Edit. Por isso, para salvar as alterações feitas usando Source Edit, é necessário sair primeiro Source Edit para exibir o texto no editor normal antes de salvar.
Usado para aplicar a formatação de parágrafo ao texto selecionado ou ao texto inserido após o cursor. Selecionar essa opção abre uma lista suspensa na qual o formato de parágrafo é selecionado.
O componente de texto também pode ser editado em linha, mas devido a restrições de espaço, nem todas as opções de formatação estão disponíveis em linha. Para ver todas as opções, alterne para o modo de tela cheia.
Essa opção permite controlar o identificador exclusivo do componente no HTML e na Data Layer.
A caixa de diálogo de design permite que o autor do modelo defina quais opções de formatação de texto estão disponíveis para os autores de conteúdo.
A guia Plug-ins é usada para ativar e desativar várias opções de formatação de texto disponíveis para os autores de conteúdo.
Os seguintes recursos podem ser ativados ou desativados para o componente.
As seguintes opções de formatação podem ser ativadas ou desativadas para o componente.
Os estilos de parágrafo podem ser ativados ou desativados para o componente. Quando ativados, os formatos permitidos podem ser definidos.
A opção para inserir caracteres especiais pode ser ativada ou desativada para o componente. Quando ativados, os caracteres permitidos podem ser definidos.
O componente de texto suporta o AEM style system.
O componente de texto suporta a Camada de Dados do Cliente Adobe.