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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Desarrollo

Creado para:

Desarrollador

Puede configurar el Editor de texto enriquecido en Adobe Experience Manager para que tenga varios editores locales. 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 locales, se ha mejorado la estructura de un tipo de nodo cq:InplaceEditingConfig con la definición del 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:

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 el nodo cq:childEditors, cree un nodo para cada editor local:

Nombre: el nombre de cada nodo es el nombre de la propiedad que representa, como en el caso de los destinos de colocación. Por ejemplo, image y text.
Tipo: cq:ChildEditorConfig

note note

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

NOTE

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

En cada uno de estos nodos (cq:ChildEditorConfig) defina las propiedades:
- Nombre: type.
- Valor: nombre del editor local registrado; por ejemplo, image y text.
- Nombre: title.
- Valor: título mostrado 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 que varios RTE creen una configuración para cada RTE local. El 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 propiedad 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 de los cuadros de diálogo de interfaz de usuario del componente.

CAUTION

No asigne un nombre al nodo de configuración RTE como 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 el proyecto aem-authoring-hybrideditors de GitHub. Puede descargar el proyecto completo como un archivo ZIP.

Adición de un editor in situ add-an-in-place-editor

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

recommendation-more-help

19ffd973-7af2-44d0-84b5-d547b0dffee2