Configurar vários editores no local

Última atualização em 2023-05-23

Você pode configurar o Editor de Rich Text no Adobe Experience Manager para que ele tenha vários editores no local. Quando configurado, é possível selecionar o conteúdo apropriado e abrir o editor apropriado.

Um editor local específico

Configurar vários editores

Para habilitar vários editores no local, a estrutura de um cq:InplaceEditingConfig tipo de nó foi aprimorado com a definição de cq:ChildEditorConfig tipo de nó.

Por exemplo:

   /**
       * Configures in-place editing of a component.
       *
       * @prop active true to activate in-place editing for the component.
       * @prop editorType ID of in-place editor to use.
       * @prop cq:childEditors collection of {@link cq:ChildEditorConfig} nodes.
       * @prop configPath path to editor's config (optional).
       * @node config editor's config (used if no configPath is specified; optional).
     */
    [cq:InplaceEditingConfig] > nt:unstructured
      - active (boolean)
      - editorType (string)
      + cq:childEditors (nt:base) = nt:unstructured
      - configPath (string)
      + config (nt:unstructured) = nt:unstructured

    /**
      * Configures one child editor for a sub-component. The name of the this node is
      * used as DD ID.
      *
      * @prop type type of the inline editor. For example, ["image"].
      * @prop title Title of the inline editor.
      * @prop icon Icon to represent the inline editor.
    */
    [cq:ChildEditorConfig] > nt:unstructured
      orderable
      - type (string)
      - title (string)

Para configurar vários editores, siga estas etapas:

  1. No nó cq:inplaceEditing (do tipo cq:InplaceEditingConfig) defina as seguintes propriedades:

    • Nome:editorType
    • Tipo: String
    • Valor: hybrid
  2. Neste nó, crie um nó:

    • Nome: cq:ChildEditors
    • Tipo: nt:unstructured
  3. Em cq:childEditors crie um nó para cada editor no local:

    • Nome: O nome de cada nó é o nome da propriedade que ele representa, como ocorre com os destinos de eliminação. Por exemplo, image e text.
    • Tipo: cq:ChildEditorConfig
    OBSERVAÇÃO

    Há uma correlação entre os alvos de eliminação definidos e os editores filhos. O nome do cq:ChildEditorConfig O nó é considerado a ID de destino de lançamento, para uso como parâmetro no editor secundário selecionado. Se a subárea editável não tiver um destino de soltar, por exemplo, em um componente de texto, o nome do editor filho ainda será considerado uma ID para identificar a área editável correspondente.

  4. Em cada um desses nós (cq:ChildEditorConfig) definir as propriedades:

    • Nome: type.

    • Valor: o nome do editor registrado no local; por exemplo, image e text.

    • Nome: title.

    • Valor: o título exibido na lista de seleção de componentes dos editores disponíveis. Por exemplo, Image e Text.

Configuração adicional para editores de rich text

A configuração de vários editores de rich text é um pouco diferente, pois é possível configurar cada instância individual do RTE separadamente. Para obter detalhes, consulte configurar o Editor de Rich Text. Para ter vários RTEs, crie uma configuração para cada RTE no local. O Adobe recomenda criar o novo nó de configuração em cq:InplaceEditingConfig já que cada RTE individual pode ter uma configuração diferente. No novo nó, crie cada configuração de RTE individual.

    texttext
        cq:dialog
        cq:editConfig
            cq:inplaceEditing
                cq:childEditors
                    someconfig
                        text1
                            rtePlugins
                        text2
                            rtePlugins
OBSERVAÇÃO

No entanto, para o RTE, a configPath a propriedade é compatível quando há apenas uma instância do editor de texto (subárea editável) no componente. Esta utilização de configPath O é fornecido para oferecer compatibilidade com versões anteriores das caixas de diálogo da interface do usuário do componente.

ATENÇÃO

Não nomeie o nó de configuração do RTE como config. Caso contrário, as configurações de RTE estarão disponíveis somente para os administradores e não para os usuários do grupo content-author.

Exemplos de código

Você pode encontrar o código desta página em projeto aem-authoring-hybrideditors no GitHub. Você pode baixar o projeto completo como um arquivo ZIP.

Adicionar um editor no local

Para obter informações gerais sobre como adicionar um editor no local, consulte o documento personalizar criação de página.

Nesta página