Configurar varios editores in-situ

Puede configurar el Editor de texto enriquecido en Adobe Experience Manager para que tenga varios editores in-situ. Cuando esté configurado, puede seleccionar el contenido adecuado y abrir el editor correspondiente.

Configurar varios editores

Para habilitar varios editores in situ, se ha mejorado la estructura de un tipo de nodo cq:InplaceEditingConfig con la definición de tipo de nodo cq:ChildEditorConfig.

Por ejemplo:

   /**
       * 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 varios editores, siga estos pasos:

1. En el nodo cq:inplaceEditing (de tipo cq:InplaceEditingConfig) defina las siguientes propiedades:

   • Nombre:editorType
   • Tipo: String
   • Value: hybrid

2. En este nodo, cree un nodo:

   • Nombre: cq:ChildEditors
   • Tipo: nt:unstructured

3. En el nodo cq:childEditors, cree un nodo para cada editor in-situ:

   • Nombre: El nombre de cada nodo es el nombre de la propiedad que representa, como sucede con los destinatarios de colocación. Por ejemplo, image y text.
   • Tipo: cq:ChildEditorConfig
   NOTA

   Existe una correlación entre los destinatarios de colocación definidos y los editores secundarios. El nombre del nodo cq:ChildEditorConfig se considera como el ID de destinatario de colocación, para utilizarlo como parámetro del editor secundario seleccionado. Si el subárea editable no tiene un destinatario de colocación, por ejemplo, en un componente de texto, el nombre del editor secundario se seguirá considerando como ID para identificar el área editable correspondiente.

4. En cada uno de estos nodos (cq:ChildEditorConfig) defina las propiedades:

   • Nombre: type.

   • Valor: El nombre del editor in situ registrado; por ejemplo, image y text.

   • Nombre: title.

   • Valor: Título que se muestra en la lista de selección de componentes de los editores disponibles. Por ejemplo, Image y Text.

Configuración adicional para editores de texto enriquecido

La configuración de varios editores de texto enriquecido es ligeramente diferente, ya que puede configurar cada instancia de RTE por separado. Para obtener más información, consulte configuración del Editor de texto enriquecido. Para tener varios RTE, cree una configuración para cada RTE in situ. Adobe recomienda crear el nuevo nodo de configuración en cq:InplaceEditingConfig ya que cada RTE individual puede tener una configuración diferente. En el nuevo nodo, cree cada configuración RTE individual.

    texttext
        cq:dialog
        cq:editConfig
            cq:inplaceEditing
                cq:childEditors
                    someconfig
                        text1
                            rtePlugins
                        text2
                            rtePlugins

Ejemplos de código

Puede encontrar el código de esta página en el proyecto aem-authoring-hybrideditors en GitHub. Puede descargar el proyecto completo como archivo ZIP.

Añadir un editor en el lugar

Para obtener información general sobre cómo agregar un editor in-situ, consulte el documento personalizar la creación de páginas.