Configurare l’editor Rich Text

L’editor Rich Text offre agli autori un’ampia gamma di funzionalità per modificare il contenuto di testo. Sono disponibili icone, caselle di selezione, barre degli strumenti e menu per un'esperienza di modifica del testo WYSIWYG.

Per informazioni sull’utilizzo delle funzioni dell’editor Rich Text per l’authoring, consulta Utilizza l’editor Rich Text per l’authoring. L’editor Rich Text può essere configurato per abilitare, disabilitare ed estendere le funzioni disponibili nei componenti di authoring. Il seguente flusso di lavoro illustra un ordine consigliato per il completamento delle attività di configurazione dell’Editor Rich Text in Experience Manager.

Figura: Sequenza di passaggi per imparare a configurare l’editor Rich Text

Interfaccia utente touch e interfaccia classica

L’interfaccia touch è quella standard, ad Experience Manager. Adobe di introduzione dell’interfaccia touch con design responsive per l’ambiente di authoring. L’interfaccia touch è progettata per i dispositivi touch e desktop. L’interfaccia di si differenzia notevolmente dall’interfaccia classica originale.

Figura: Barra degli strumenti dell’Editor Rich Text nell’interfaccia utente touch

Figura: Barra degli strumenti dell’Editor Rich Text nell’interfaccia classica

Varie modalità di editing

Gli autori possono creare e modificare il contenuto testuale in Experience Manager utilizzando le diverse modalità dei componenti. Le opzioni della barra degli strumenti per l’authoring e la formattazione dei contenuti e l’esperienza utente dei componenti abilitati per l’editor Rich Text in diverse modalità di modifica variano in base alle configurazioni dell’editor Rich Text.

Modifica in linea

All’apertura (con un doppio tocco o clic lento) è possibile modificare il contenuto all’interno della pagina. Viene visualizzata una barra degli strumenti compatta con opzioni di base.

Figura: Modifica in linea con barra degli strumenti di base nell’interfaccia utente touch

Nell’interfaccia classica, un doppio clic lento sul componente consente la modifica in linea e un contorno arancione evidenzia il contenuto. Se Content Finder è aperto, nella parte superiore della finestra viene visualizzata una barra degli strumenti con le opzioni di formattazione RTE disponibili. Se Content Finder non è aperto, le opzioni di formattazione non vengono visualizzate ed è possibile apportare solo semplici modifiche al testo.

Modifica a tutto schermo

I componenti di Experience Manager possono essere aperti in visualizzazione a schermo intero che nasconde il contenuto della pagina e occupa lo schermo disponibile. Prendi in considerazione la modifica a schermo intero di una versione dettagliata della modifica in linea, in quanto offre le opzioni di modifica più avanzate. Per aprirlo, fai clic su , dalla barra degli strumenti compatta quando si utilizza la modalità di modifica in linea.

Nella finestra di dialogo in modalità a tutto schermo, insieme a una barra degli strumenti dettagliata dell’editor Rich Text, sono disponibili anche le opzioni e i componenti disponibili in una finestra di dialogo. È applicabile solo a una finestra di dialogo che contiene l’editor Rich Text insieme ad altri componenti.

Figura: Barra degli strumenti dettagliata dell’editor Rich Text in modalità a tutto schermo nell’interfaccia utente touch

Modifica finestre di dialogo

Quando si fa doppio clic su un componente, viene visualizzata una finestra di dialogo per la modifica del contenuto. La finestra di dialogo viene visualizzata sopra la pagina esistente. In alcuni scenari specifici, la finestra di dialogo si apre come finestra pop-up. Ad esempio, quando un componente Testo fa parte di una colonna in un layout di pagina a più colonne e l’area disponibile per la finestra di dialogo è inferiore.

Figura: Modalità di modifica delle finestre di dialogo nell’interfaccia utente touch

Figura: Finestra di dialogo nell’interfaccia classica che contiene una barra degli strumenti dettagliata per la modifica

Informazioni sui plug-in dell’editor Rich Text e sulle funzioni associate

Questa funzionalità è disponibile tramite una serie di plug-in, ciascuno con:

• A features proprietà:

  • Utilizzato per attivare o disattivare le funzionalità di base di quel plug-in
  • Che può essere configurato utilizzando una procedura standard

• Se necessario, proprietà e opzioni aggiuntive che richiedono una configurazione specializzata.

Le funzioni di base dell’editor Rich Text vengono attivate o disattivate dal valore features su un nodo specifico del plug-in appropriato.

Nella tabella seguente sono elencati i plug-in correnti:

• ID plug-in con collegamento alla documentazione API. ID viene utilizzato come nome del nodo quando attivazione di un plug-in.
• Valori consentiti per features proprietà.
• Descrizione delle funzionalità fornite dal plug-in.

Comprendere i percorsi e le posizioni di configurazione

Il modalità di modifica dell’editor Rich Text (e interfaccia utente) che fornisci agli autori per decidere la posizione dei dettagli di configurazione quando sei attivazione dei plug-in dell’editor Rich Text:

Configura le seguenti proprietà che si applicano in modalità di modifica Finestra di dialogo solo nell’interfaccia utente touch:

• useFixedInlineToolbar: imposta questa proprietà booleana definita nel nodo dell’editor Rich Text (uno con sling:resourceType= cq/gui/components/authoring/dialog/richtext) a True, per fissare la barra degli strumenti dell’Editor Rich Text anziché mobile.

  Quando questa proprietà è true, la modifica del testo Rich Text viene avviata per impostazione predefinita sull'evento "foundation-contentloaded".

  Per evitare questo problema, imposta la proprietà customStart a Truee attiva l’evento "rte-start" per avviare la modifica dell’editor Rich Text. Quando questa proprietà è impostata su 'true', il comportamento predefinito, ovvero la velocità di avvio al clic, non funziona.

• customStart: imposta questa proprietà booleana definita nel nodo dell’editor Rich Text su True, per controllare quando avviare l’editor Rich Text attivando l’evento rte-start.

• rte-start: attiva questo evento sul contenteditable-div dell’editor Rich Text, quando iniziare a modificare l’editor Rich Text. Questo funziona solo se customStart è stato impostato su true.

Quando si utilizza l’editor Rich Text nella finestra di dialogo touch, impostare la proprietà useFixedInlineToolbar per evitare problemi, è obbligatorio impostare su true.

Personalizzazione della modifica diretta

Puoi definire su quale selettore di HTML viene avviato l’editor di testo configurando le seguenti proprietà:

• editElementQuery - Definito il cq:InplaceEditingConfig, questa proprietà viene utilizzata per specificare un selettore dell’elemento HTML su cui verrà avviata la modifica in linea per il componente Testo. Se non viene specificato diversamente, la modifica in linea viene avviata direttamente sul componente Testo di HTML.
• textPropertyName - Definito il cq:InplaceEditingConfig, questa proprietà viene utilizzata per specificare il nome della proprietà che verrà salvata nel nodo del contenuto, in cui il valore HTML del componente testo verrà mantenuto dopo la modifica in linea.

La proprietà corrispondente per la modalità finestra di dialogo è name.

Abilitare le funzionalità dell’editor Rich Text attivando i plug-in

Le funzionalità dell’editor Rich Text sono disponibili tramite una serie di plug-in, ciascuno con la proprietà Features. Puoi configurare la proprietà features per abilitare o disabilitare le varie funzioni di ciascun plug-in.

Per configurazioni dettagliate dei plug-in dell’editor Rich Text, consulta come attivare e configurare i plug-in dell’editor Rich Text.

Esempio: download questa configurazione di esempio che illustra come configurare l’editor Rich Text. In questo pacchetto sono abilitate tutte le funzioni.

Configurare la barra degli strumenti dell’editor Rich Text

AEM consente di configurare l’interfaccia per l’Editor Rich Text in modo diverso a seconda delle diverse modalità di modifica. Di seguito sono riportate le impostazioni predefinite. Puoi modificare questi valori predefiniti in base alle tue esigenze. Puoi personalizzare solo le funzioni della barra degli strumenti che desideri fornire agli autori. Non è necessario specificare tutte le configurazioni della barra degli strumenti.

Per configurare la barra degli strumenti per dialogFullScreen, utilizza la seguente configurazione di esempio.

<uiSettings jcr:primaryType="nt:unstructured">
  <cui jcr:primaryType="nt:unstructured">
    <inline
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,#justify,#lists,links#modifylink,links#unlink,#paraformat]">
      <popovers jcr:primaryType="nt:unstructured">
        <justify
          jcr:primaryType="nt:unstructured"
          items="[justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify]"
          ref="justify"/>
        <lists
          jcr:primaryType="nt:unstructured"
          items="[lists#unordered,lists#ordered,lists#outdent,lists#indent]"
          ref="lists"/>
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </inline>
    <dialogFullScreen
      jcr:primaryType="nt:unstructured"
      toolbar="[format#bold,format#italic,format#underline,justify#justifyleft,justify#justifycenter,justify#justifyright,justify#justifyjustify,lists#unordered,lists#ordered,lists#outdent,lists#indent,links#modifylink,links#unlink,table#createoredit,#paraformat,image#imageProps]">
      <popovers jcr:primaryType="nt:unstructured">
        <paraformat
          jcr:primaryType="nt:unstructured"
          items="paraformat:getFormats:paraformat-pulldown"
          ref="paraformat"/>
      </popovers>
    </dialogFullScreen>
    <tableEditOptions
      jcr:primaryType="nt:unstructured"
      toolbar="[table#insertcolumn-before,table#insertcolumn-after,table#removecolumn,-,table#insertrow-before,table#insertrow-after,table#removerow,-,table#mergecells-right,table#mergecells-down,table#mergecells,table#splitcell-horizontal,table#splitcell-vertical,-,table#selectrow,table#selectcolumn,-,table#ensureparagraph,-,table#modifytableandcell,table#removetable,-,undo#undo,undo#redo,-,table#exitTableEditing,-]">
    </tableEditOptions>
  </cui>
</uiSettings>

Vengono utilizzate diverse impostazioni dell’interfaccia utente per la modalità in linea e per la modalità a schermo intero. La proprietà toolbar viene utilizzata per specificare i pulsanti della barra degli strumenti.

Ad esempio, se il pulsante è esso stesso una feature (ad esempio, Bold), è specificato come PluginName#FeatureName (ad esempio, links#modifylink).

Se il pulsante è un elemento a comparsa (contenente alcune caratteristiche di un plug-in), viene specificato come #PluginName (ad esempio, #format).

Separatori (|) tra un gruppo di pulsanti può essere specificato con -.

Il nodo pop-up in modalità in linea o a schermo intero contiene un elenco dei popover utilizzati. Ogni nodo figlio sotto il nodo 'popovers' prende il nome dal plug-in (ad esempio, il formato). La proprietà 'items' contiene un elenco di caratteristiche del plug-in (ad esempio, format#bold).

Impostazioni dell’interfaccia utente e criteri dei contenuti dell’Editor Rich Text

Gli amministratori possono controllare le opzioni dell’editor Rich Text utilizzando i criteri del contenuto, ad esempio anziché eseguire la configurazione come descritto in precedenza. I criteri del contenuto definiscono le proprietà di progettazione di un componente quando viene utilizzato come parte di un modello modificabile. Ad esempio, se un componente testo che utilizza l’editor Rich Text viene utilizzato con un modello modificabile, il criterio del contenuto può definire che l’opzione grassetto sia disponibile e che siano disponibili alcune opzioni di formattazione di paragrafo. I criteri per i contenuti sono riutilizzabili e possono essere applicati a più modelli.

Le opzioni disponibili nell’editor Rich Text scorrono a valle dalle configurazioni dell’interfaccia utente ai criteri dei contenuti.

• Le impostazioni di configurazione dell’interfaccia utente definiscono le opzioni disponibili per i criteri dei contenuti.
• Se la configurazione dell'interfaccia utente dell'editor Rich Text è stata rimossa o non è stata abilitata per un elemento, il criterio del contenuto non è in grado di configurarlo.
• Un autore ha accesso solo alle funzionalità rese disponibili dalle configurazioni dell’interfaccia utente e dai criteri dei contenuti.

Ad esempio, è possibile visualizzare Documentazione dei componenti core testo.

Personalizzare la mappatura tra icone e comandi della barra degli strumenti

È possibile personalizzare la mappatura tra le icone Coral visualizzate sulla barra degli strumenti dell'editor Rich Text e i comandi disponibili. Oltre alle icone Coral, non è possibile utilizzare altre icone.

1. Crea un nodo denominato icons in uiSettings/cui.

2. Crea nodi per le singole icone al di sotto di esso.

3. Su ciascuno dei singoli nodi delle icone, specificate un'icona Coral e un comando da mappare sull'icona.

Di seguito è riportato uno snippet di esempio per mappare il comando Grassetto all’icona rosso corallo denominata textItalic.

<text jcr:primaryType="nt:unstructured" sling:resourceType="cq/gui/components/authoring/dialog/richtext" name="./text" useFixedInlineToolbar="{Boolean}true">
    <rtePlugins jcr:primaryType="nt:unstructured">
        <format jcr:primaryType="nt:unstructured" features="bold,italic"/>
    </rtePlugins>
    <uiSettings jcr:primaryType="nt:unstructured">
        <cui jcr:primaryType="nt:unstructured">
            <inline jcr:primaryType="nt:unstructured"
                toolbar="[format#bold,format#italic,format#underline,links#modifylink,links#unlink]">
            </inline>
            <icons jcr:primaryType="nt:unstructured">
                <bold jcr:primaryType="nt:unstructured"
                    command="format#bold"
                    icon="textItalic"/>
            </icons>
        </cui>
    </uiSettings>
</text>

Passa all’editor Rich Text di CoralUI 2

In una pagina, puoi includere la libreria client di CoralUI 2 RTE o la libreria client di CoralUI 3 RTE. Per impostazione predefinita, l’Editor Rich Text include la libreria client CoralUI 3 RTE. Per passare a CoralUI 2 RTE, effettuare le seguenti operazioni.

1. Sovrapponi il nodo /libs/cq/gui/components/authoring/editors/clientlibs/core in /appsed eseguire le operazioni seguenti:

   • Sostituisci rte.coralui3 con rte.coralui2 per la proprietà dependencies.
   • Sostituisci cq.authoring.editor.core.inlineediting.rte.coralui3 con cq.authoring.editor.core.inlineediting.rte.coralui2 per la proprietà embed.
   • Sostituisci cq.authoring.rte.coralui3 con cq.authoring.rte.coralui2 per la proprietà embed.

2. Sovrapponi i nodi /libs/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui3 e /libs/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui2 in /apps.

   Rimuovi categoria cq.authoring.dialog da /apps/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui3 e aggiungerlo a /apps/cq/gui/components/authoring/dialog/richtext/clientlibs/rte/coralui2.

3. Modifica qualsiasi altra dipendenza inclusa nella pagina da rte.coralui3 a rte.coralui2. Ad esempio, dopo aver sovrapposto il nodo /libs/mcm/campaign/components/touch-ui/clientlibs/rte in /apps, modificare qualsiasi dipendenza da esso rte.coralui3 a rte.coralui2.

4. Sovrapponi il nodo cq/ui/widgets in /apps. Sostituire la dipendenza cq.rte nel nodo /apps/cq/ui/widgets con cq.coralui2.rte.

Ulteriori informazioni

Per ulteriori informazioni sulla configurazione dell’editor Rich Text, consulta API widget AEM riferimento.

In particolare, per visualizzare i plug-in e le opzioni correlate disponibili:

• Il CQ.form.RichText Questo componente fornisce un campo modulo per la modifica delle informazioni sul testo formattato (testo formattato). Per informazioni su tutti i parametri disponibili per il modulo Rich Text, vedere Opzioni di configurazione.

• Il componente Rich Text offre un’ampia gamma di funzionalità tramite i plug-in elencati in CQ.form.rte.plugins.Plugin. Per ogni plug-in:

  • Per informazioni dettagliate sulle funzionalità che è possibile attivare (o disattivare), vedere Funzionalità.
  • Per informazioni dettagliate sulla configurazione del plug-in appropriato, consulta Opzioni di configurazione per tutti i parametri disponibili.

• Sono inoltre disponibili ulteriori informazioni sulle regole HTML per i collegamenti.

che possono essere utilizzati per estendere e personalizzare l’editor Rich Text. Ad esempio, per elencare gli ancoraggi disponibili nella pagina durante la creazione di un collegamento, puoi fornire la tua implementazione di LinkPlugin.

Limitazioni note

La funzionalità AEM RTE presenta le seguenti limitazioni:

• Le funzionalità di editor Rich Text sono supportate solo nelle finestre di dialogo dei componenti AEM. L’editor Rich Text non è supportato nelle creazioni guidate o nei moduli Foundation come Proprietà pagina e Scaffolding sull’interfaccia touch.

• L’AEM non funziona su Dispositivi ibridi.

• Non denominare il nodo di configurazione dell’editor Rich Text config. In caso contrario, la configurazione dell’editor Rich Text avrà effetto solo per gli amministratori e non per gli utenti del gruppo content-author.

• L’editor Rich Text non supporta il frame in linea o l’iframe per incorporare il contenuto.

Best practice e suggerimenti

• Abilita solo i plug-in senza pop-up per una finestra di dialogo mobile. I plug-in senza pop-up sono di dimensioni ridotte e sono più adatti per una finestra di dialogo mobile.
• Abilita i plug-in con pop-up più grandi, ad esempio Paste plug-in, solo nella modalità di dialogo a schermo intero o in modalità a schermo intero. I plug-in con un pop-up di grandi dimensioni richiedono più spazio sullo schermo per fornire una buona esperienza di authoring.
• Se utilizzi plug-in personalizzati per CoralUI3 RTE, utilizza rte.coralui3 libreria.

Risoluzione dei problemi frequenti relativi all’editor Rich Text

Come selezionare più celle di tabella?

Per selezionare più celle in una tabella, premere Ctrl o Cmd e quindi fare clic sulle celle della tabella una per una.

A questo punto eseguire l'operazione sulla selezione, ad esempio impostare le proprietà delle celle selezionate.

I collegamenti ipertestuali vengono persi quando si modifica un componente utilizzando il pulsante Configura

Aggiungere un collegamento ipertestuale in un componente testo modificandolo tramite il pulsante Configura. È possibile che il collegamento ipertestuale venga perso quando viene modificato di nuovo e convalidato per la seconda volta.

Una soluzione consiste nel fare clic nel componente testo quando viene visualizzata la seconda volta la finestra di dialogo per modifica, quindi eseguire la convalida del collegamento.

Questo problema è stato risolto con AEM 6.3 e versioni successive.

Il contenuto HTML aggiunto in modalità di modifica sorgente viene perso

Non aggiungere un HTML XSS-prone. L’AEM, e non l’editor Rich Text, può rimuovere alcuni contenuti HTML per rispettare le regole antisamiche XSS.

Per verificare che il HTML incollato sia stato salvato, controlla il contenuto salvato in CRXDE (nel nodo del contenuto).

Se non viene salvato, il HTML deve essere stato rimosso dall’editor Rich Text in quanto non è conforme alle regole dell’editor Rich Text.

Se salvato in CRXDE ma non renderizzato sulla pagina (per verificare il rendering, vedi anteprima, viene rimosso dalle regole AEM XSS.

Il componente Multifield non funziona come previsto

Per creare un componente con più campi, utilizza esclusivamente CoralUI 3. Non utilizzare le finestre di dialogo dei componenti di CoralUI 2.

Inoltre, verifica che il codice di implementazione multifield e la struttura dei nodi siano corretti.

La configurazione disponibile per gli amministratori non è disponibile per gli autori

Se gli aggiornamenti delle configurazioni dell’interfaccia vengono applicati agli amministratori ma non agli account di authoring, assicurati che il nodo di configurazione non sia denominato config. Utilizza il configPath proprietà.

Risorse Business.Adobe.com

Ecommerce Integrations Targeted Content Asset Collections Web Content Management Digital Rights Management Content Management System