Documentación AEM 6.4 Guía de desarrollo

Configuración de varios editores in situ configure-multiple-in-place-editors

Last update: Fri May 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Developing

Creado para:

Developer

CAUTION

AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

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.

Un editor local específico

Configuración de varios editores configure-multiple-editors

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

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:

En el nodo cq:inplaceEditing (de tipo cq:InplaceEditingConfig) defina las siguientes propiedades:
- Nombre:editorType
- Tipo: String
- Valor: hybrid
En este nodo, cree un nodo:
- Nombre: cq:ChildEditors
- Tipo: nt:unstructured

En 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 destinos de colocación. Por ejemplo, image y text.
Tipo: cq:ChildEditorConfig

note note

note note
NOTE
Existe una correlación entre los objetivos de colocación definidos y los editores secundarios. El nombre del `cq:ChildEditorConfig` se considera como el ID de destino de colocación, para utilizarlo como parámetro en el editor secundario seleccionado. Si el área secundaria editable no tiene un destino de colocación, por ejemplo, en un componente de texto, el nombre del editor secundario seguirá considerándose como un ID para identificar el área editable correspondiente.

NOTE

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

En cada uno de estos nodos (cq:ChildEditorConfig) definen 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 additional-configuration-for-rich-text-editors

La configuración de varios editores de texto enriquecido es ligeramente diferente, ya que puede configurar cada instancia de RTE individual por separado. Para obtener más información, consulte configurar el 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 de RTE individual.

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

NOTE

Sin embargo, para RTE, la variable configPath se admite cuando solo hay una instancia del editor de texto (subárea editable) en el componente. Este uso de configPath se proporciona para admitir la compatibilidad con versiones anteriores con cuadros de diálogo de interfaz de usuario del componente.

CAUTION

No asigne al nodo de configuración RTE el nombre config. De lo contrario, las configuraciones de RTE solo están disponibles para los administradores y no para los usuarios del grupo content-author.

Muestras de código code-samples

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

Añadir un editor in situ add-an-in-place-editor

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

recommendation-more-help

2315f3f5-cb4a-4530-9999-30c8319c520e