Personalização do Editor universal customizing

Última atualização: 16 de dezembro de 2025

Aplica-se a:
Experience Manager as a Cloud Service

Tópicos:
Developing

Criado para:

Admin
Developer

Saiba mais sobre as diferentes opções para personalizar o Editor universal para atender às necessidades dos autores de conteúdo.

TIP

O Editor Universal também oferece muitos pontos de extensão, permitindo expandir sua funcionalidade para atender às necessidades do projeto.

Uso de tags de configuração do Meta meta-tags

Alguns fluxos de trabalho de criação podem exigir o uso de alguns recursos do Editor universal, e não de outros. Para dar suporte a esses casos diversos, metatags estão disponíveis para configurar ou desativar determinados recursos ou botões do editor.

Desativando recursos disable-features

Use esta marca na seção <head> da página para desabilitar um ou mais recursos:

<meta name="urn:adobe:aue:config:disable" content="..." />

Se quiser desativar vários recursos, forneça uma lista de valores separados por vírgulas.

A seguir estão os valores com suporte para content, ou seja, os recursos que podem ser desabilitados com metatags.

Valor do conteúdo

Descrição

publish

Desabilite toda a funcionalidade de publicação, ou seja, o botão Publicar e o botão Cancelar publicação

publish-live

Desabilitar a publicação em tempo real

publish-preview

Desabilitar publicação de visualização (se o serviço de visualização estiver disponível)

unpublish

Desabilitar o botão Cancelar publicação

copy

Desabilita os botões copiar e colar

duplicate

Desabilita o botão duplicar

header-open-page

Desabilita o botão Abrir página

aem-dev-login

Desabilita o botão de logon do desenvolvedor

Definição do modo de editor defining-mode

Você pode forçar o Editor universal a abrir em um modo específico. Use esta marca na seção <head> da página para forçar o modo do editor:

<meta name="urn:adobe:aue:config:mode" content="..." />

A seguir estão os valores com suporte para content, ou seja, os recursos que podem ser desabilitados com metatags.

Valor do conteúdo

Descrição

preview

O editor é aberto no modo de visualização. O ícone Visualizar está oculto e o usuário não pode voltar para o modo de edição.

readonly

O editor se abre no modo somente leitura. O botão Propriedades e o painel estão ocultos. Os detalhes estão disponíveis na árvore de conteúdo, mas nenhuma alteração pode ser feita.

Ao definir modos por meio de metatags, os modos não podem ser substituídos pelo usuário.

URLs de visualização personalizados custom-preview-urls

Você pode especificar uma URL de visualização personalizada por meio de uma metaconfiguração de urn:adobe:aue:config:preview, que será aberta ao clicar no botão Abrir página na barra de ferramentas superior direita do editor 🔗.

Para fazer isso, basta incluir o URL de visualização desejado em uma meta tag do aplicativo instrumentado, como no exemplo a seguir.

<meta name="urn:adobe:aue:config:preview" content="https://wknd.site"/>

Alterando seu endpoint custom-endpoint

Se você não quiser usar o Universal Editor Service, que é hospedado pela Adobe, mas sua própria versão hospedada, poderá defini-lo em uma meta tag. Consulte o documento Introdução ao Editor Universal no AEM para obter detalhes.

Componentes de filtragem filtering-components

Você pode restringir os componentes permitidos por contêiner no Editor universal usando filtros de componente. Consulte o documento Componentes de Filtragem para obter mais informações.

Mostrar e ocultar componentes condicionalmente no painel Propriedades conditionally-hide

Embora um componente ou componentes possam estar disponíveis para os autores, pode haver certas situações em que isso não faça sentido. Nesses casos, você pode ocultar componentes no painel de propriedades adicionando um atributo condition aos campos do modelo de componente.

As condições podem ser definidas usando o esquema JsonLogic. Se a condição for verdadeira, o campo será exibido. Se a condição for falsa, o campo ficará oculto.

Modelo de amostra

code language-json

 {
    "id": "conditionally-revealed-component",
    "fields": [
      {
        "component": "boolean",
        "label": "Shall the text field be revealed?",
        "name": "reveal",
        "valueType": "boolean"
      },
      {
        "component": "text-input",
        "label": "Hidden text field",
        "name": "hidden-text",
        "valueType": "string",
        "condition": { "===": [{"var" : "reveal"}, true] }
      }
    ]
 }

Condição falsa

Condição Verdadeira

Limitação: condições dentro de contêineres de vários campos conditions-multi-field-limitation

A resolução da condição var é absoluta, não relativa à linha atual. Um var deve ser um fieldName de nível raiz ou, para campos dentro de um contêiner, deve ter o nome do contêiner como containerName|fieldName.

A mesma abordagem não funciona para vários contêineres (linhas repetíveis). O conteúdo da linha é indexado no tempo de execução como containerName/0|fieldName, containerName/1|fieldName, etc., mas esse índice não é conhecido durante a criação da condição e é alternado à medida que as linhas são adicionadas, removidas ou reordenadas. Como resultado, não há como um autor segmentar um campo específico na mesma linha, portanto, as condições em vários contêineres não são compatíveis.

recommendation-more-help

experience-manager-cloud-service-help-main-toc