Configurare i plug-in Editor Rich Text

Le funzionalità dell’editor Rich Text sono disponibili tramite una serie di plug-in, ciascuno con proprietà features . Puoi configurare la proprietà feature per attivare o disattivare una o più funzioni dell’editor Rich Text. Questo articolo descrive come configurare in modo specifico i plug-in RTE.

Per informazioni dettagliate sulle altre configurazioni dell’editor Rich Text, consulta configurare l’editor Rich Text.

NOTA

Quando si lavora con CRXDE Lite, è consigliabile salvare regolarmente le modifiche utilizzando Salva tutto opzione .

Attivare un plug-in e configurare la proprietà features

Per attivare un plug-in, effettua le seguenti operazioni. Alcuni passaggi sono necessari solo quando configuri un plug-in per la prima volta, in quanto i nodi corrispondenti non esistono.

Per impostazione predefinita, format, link, list, justifye control I plug-in e tutte le relative funzioni sono abilitati nell’editor Rich Text.

NOTA

I rispettivi rtePlugins nodo è indicato come <rtePlugins-node> per evitare duplicazioni in questo articolo.

  1. Utilizzando CRXDE Lite, individua il componente di testo per il progetto.

  2. Crea il nodo principale di <rtePlugins-node> se non esiste, prima di configurare eventuali plug-in RTE:

    • A seconda del componente, i nodi principali sono:

      • config: .../text/cq:editConfig/cq:inplaceEditing/config
      • un nodo di configurazione alternativo: .../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
      • text: .../text/dialog/items/tab1/items/text
    • Sono di tipo: jcr:primaryType cq:Widget

    • Entrambi dispongono della seguente proprietà:

      • Nome name
      • Tipo String
      • Valore ./text
  3. A seconda dell’interfaccia per la quale stai configurando, crea un nodo <rtePlugins-node>, se non esiste:

    • Nome rtePlugins
    • Tipo nt:unstructured
  4. Di seguito, crea un nodo per ogni plug-in che desideri attivare:

    • Tipo nt:unstructured
    • Nome ID plug-in del plug-in richiesto

Dopo aver attivato un plug-in, segui queste linee guida per configurare il features proprietà.

Abilita tutte le funzionalità Abilita alcune funzioni specifiche. Disattiva tutte le funzioni.
Nome caratteristiche caratteristiche caratteristiche
Tipo Stringa String (multistringa; imposta tipo su String e fai clic su Multi in CRXDE Lite) Stringa
Valore * (un asterisco) Imposta uno o più valori di feature. -

Comprendere il plug-in più recente

La findreplace il plug-in non richiede alcuna configurazione. Funziona fuori dagli schemi.

Quando si utilizza la funzionalità di sostituzione, la stringa sostitutiva deve essere immessa contemporaneamente alla stringa da trovare. Tuttavia, è ancora possibile fare clic su Trova per cercare la stringa prima di sostituirla. Se la stringa sostitutiva viene immessa dopo aver fatto clic su Trova, la ricerca riprende dall’inizio del testo.

La finestra di dialogo Trova e sostituisci diventa trasparente quando si fa clic su Trova e diventa opaca quando si fa clic su Sostituisci. Il comportamento consente all’autore di rivedere il testo da sostituire. Se gli utenti fanno clic su sostituisci tutto, la finestra di dialogo viene chiusa e viene visualizzato il numero di sostituzioni effettuate.

Configurare le modalità Incolla

Quando si utilizza l’editor Rich Text, gli autori possono incollare i contenuti in una delle tre modalità seguenti:

  • Modalità browser: Incolla il testo utilizzando l’implementazione di incolla predefinita del browser. Non è un metodo consigliato in quanto potrebbe introdurre markup indesiderati.

  • Modalità testo normale: Incolla il contenuto degli Appunti come testo normale. Rimuove tutti gli elementi di stile e formattazione dal contenuto copiato prima di inserire in Experience Manager componente.

  • Modalità MS Word: Incolla il testo, incluse le tabelle, con la formattazione durante la copia da MS Word. La copia e l'incolla del testo da un'altra origine, ad esempio una pagina Web o MS Excel, non è supportata e mantiene solo la formattazione parziale.

Configurare le opzioni Incolla disponibili nella barra degli strumenti dell’Editor Rich Text

Puoi fornire alcune, tutte o nessuna di queste tre icone agli autori nella barra degli strumenti dell’editor Rich Text:

  • Incolla (Ctrl+V): Può essere preconfigurato per corrispondere a una delle tre modalità Incolla di cui sopra.

  • Incolla come testo: Offre funzionalità per la modalità testo normale.

  • Incolla da Word: Fornisce la funzionalità della modalità MS Word.

Per configurare l’editor Rich Text per visualizzare le icone richieste, effettua le seguenti operazioni.

  1. Passa al componente, ad esempio /apps/<myProject>/components/text.
  2. Passa al nodo rtePlugins/edit. Vedi attivare un plug-in se il nodo non esiste.
  3. Crea il features sulla proprietà edit e aggiungi una o più funzioni. Salva tutte le modifiche.

Configurare il comportamento dell’icona Incolla (Ctrl+V) e della scelta rapida

Puoi preconfigurare il comportamento della Incolla (Ctrl+V) , utilizzando i seguenti passaggi. Questa configurazione definisce anche il comportamento della scelta rapida da tastiera Ctrl+V che gli autori utilizzano per incollare il contenuto.

La configurazione consente i seguenti tre tipi di casi d’uso:

  • Incolla il testo utilizzando l’implementazione di incolla predefinita del browser. Non è un metodo consigliato in quanto potrebbe introdurre markup indesiderati. Configurato utilizzando browser sotto.

  • Incolla il contenuto degli Appunti come testo normale. Rimuove tutti gli elementi di stile e formattazione dal contenuto copiato prima di inserire in Experience Manager componente. Configurato utilizzando plaintext sotto.

  • Incolla il testo, incluse le tabelle, con la formattazione durante la copia da MS Word. La copia e l'incolla del testo da un'altra origine, ad esempio una pagina Web o MS Excel, non è supportata e mantiene solo la formattazione parziale. Configurato utilizzando wordhtml sotto.

  1. Nel componente, accedi a <rtePlugins-node>/edit nodo. Crea i nodi se i nodi non esistono. Per ulteriori informazioni, consulta attivare un plug-in.

  2. In edit creare una proprietà utilizzando i seguenti dettagli:

    • Nome defaultPasteMode
    • Tipo String
    • Valore è una delle modalità di incolla richieste da browser, plaintextoppure wordhtml modalità.

Configurare i formati consentiti per incollare il contenuto

Incolla come Microsoft-Word (paste-wordhtml) può essere ulteriormente configurata in modo da poter consentire esplicitamente alcuni stili quando si incolla Experience Manager da un altro programma, quali Microsoft Word.

Ad esempio, se è consentito incollare solo formati ed elenchi in grassetto Experience Manager, puoi filtrare gli altri formati. Questa operazione è denominata filtro di incolla configurabile, che può essere eseguito per entrambi:

Per i collegamenti è inoltre possibile definire i protocolli accettati automaticamente.

Per configurare quali formati sono consentiti quando si incolla testo in Experience Manager da un altro programma:

  1. Nel componente, accedi al nodo <rtePlugins-node>/edit. Crea i nodi se il nodo non esiste. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Crea un nodo sotto il edit nodo per mantenere le regole di incolla di HTML:

    • Nome htmlPasteRules
    • Tipo nt:unstructured
  3. Crea un nodo sotto htmlPasteRules, per contenere i dettagli dei formati di base consentiti:

    • Nome allowBasics
    • Tipo nt:unstructured
  4. Per controllare i singoli formati accettati, creare una o più delle seguenti proprietà nella allowBasics nodo:

    • Nome bold
    • Nome italic
    • Nome underline
    • Nome anchor (sia per i collegamenti che per gli ancoraggi denominati)
    • Nome image

    Tutte le proprietà sono di Tipo Boolean, nella misura appropriata Valore puoi selezionare o rimuovere il segno di spunta per abilitare o disabilitare la funzionalità.

    NOTA

    Se non è definito in modo esplicito, viene utilizzato il valore predefinito true e il formato viene accettato.

  5. È inoltre possibile definire altri formati utilizzando un intervallo di altre proprietà o nodi, applicati anche a htmlPasteRules nodo:

Proprietà Tipo Descrizione
allowBlockTags String Definisce l’elenco dei tag di blocco consentiti. Alcuni possibili tag di blocco includono titoli (h1, h2, h3), paragrafi §, elenchi (ol, ul), tabelle (tabella).
fallbackBlockTag String Definisce il tag blocco utilizzato per tutti i blocchi con un tag blocco non incluso in allowBlockTags. Di solito, p sufficiente.
table nt:unstructured Definisce il comportamento da seguire per incollare le tabelle. Per definire se è consentito incollare tabelle, questo nodo deve disporre della proprietà allow (type Boolean). Se allow è impostato su false, è necessario specificare la proprietà ignoreMode (type String) per definire la modalità di gestione del contenuto della tabella incollata. I valori validi per ignoreMode sono remove per rimuovere il contenuto della tabella e paragraph per trasformare le celle della tabella in paragrafi.
list nt:unstructured Definisce il comportamento durante l’incollaggio degli elenchi. Deve avere la proprietà allow (tipo booleano) per definire se è consentito incollare elenchi. Se allow è impostato su false, specifica la proprietà ignoreMode (tipo String) per definire la modalità di gestione del contenuto di un elenco incollato. I valori validi per ignoreMode sono remove che rimuove il contenuto dell'elenco e paragraph che trasforma le voci di elenco in paragrafi.

Esempio di un valore valido htmlPasteRules La struttura è qui sotto:

"htmlPasteRules": {
    "allowBasics": {
        "italic": true,
        "link": true
    },
    "allowBlockTags": [
        "p", "h1", "h2", "h3"
    ],
    "list": {
        "allow": false,
        "ignoreMode": "paragraph"
    },
    "table": {
        "allow": true,
        "ignoreMode": "paragraph"
    }
}
  1. Salva tutte le modifiche.

Configurare gli stili di testo

Gli autori possono applicare gli stili per modificare l’aspetto di una parte di testo. Gli stili si basano sulle classi CSS predefinite nel foglio di stile CSS. Il contenuto stilizzato è racchiuso in span che utilizzano class per fare riferimento alla classe CSS . Ad esempio:

<span class=monospaced>Monospaced Text Here</span>

Quando il plug-in Stili è attivato per la prima volta, non è disponibile alcun Stili predefinito. L'elenco a comparsa è vuoto. Per fornire gli autori Stili, procedi come segue:

  • Attiva il selettore a discesa Stile .
  • Specificare una o più posizioni dei fogli di stile.
  • Specificare i singoli stili che è possibile selezionare dall’elenco a comparsa Stile.

Per le riconfigurazioni successive, ad esempio per aggiungere altri stili, seguire solo le istruzioni per fare riferimento a un nuovo foglio di stile e specificare gli stili aggiuntivi.

NOTA

Gli stili possono essere definiti anche per tabelle o celle di tabella. Queste configurazioni richiedono procedure separate.

Attiva l’elenco a discesa Stile

A questo scopo, abilita il plug-in Stili.

  1. Nel componente, accedi al nodo <rtePlugins-node>/styles. Crea i nodi se i nodi non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Crea il features sulla proprietà styles nodo:

    • Nome features
    • Tipo String
    • Valore * (asterisco)
  3. Salva tutte le modifiche.

NOTA

Una volta abilitato il plug-in Stili, l’elenco a discesa Stile viene visualizzato nella finestra di dialogo di modifica. Tuttavia, l’elenco è vuoto in quanto non è configurato alcun stile.

Specificare la posizione del foglio di stile

Quindi, specificare le posizioni dei fogli di stile a cui si desidera fare riferimento:

  1. Passa al nodo principale del componente testo, ad esempio /apps/<myProject>/components/text.

  2. Aggiungi la proprietà externalStyleSheets al nodo principale di <rtePlugins-node>:

    • Nome externalStyleSheets
    • Tipo String[] (multistringa; click Multi in CRXDE)
    • Valore(i) Il percorso e il nome del file di ogni foglio di stile che si desidera includere. Utilizza i percorsi del repository.
    NOTA

    È possibile aggiungere riferimenti a fogli di stile aggiuntivi in qualsiasi momento successivo.

  3. Salva tutte le modifiche.

Quando si utilizza l’editor Rich Text in una finestra di dialogo (interfaccia classica) È possibile specificare fogli di stile ottimizzati per la modifica di testo RTF. A causa di limitazioni tecniche, il contesto CSS viene perso nell’editor, quindi puoi emulare questo contesto per migliorare l’esperienza WYSIWYG.

L’editor Rich Text utilizza un elemento DOM contenitore con un ID di CQrte che offre diversi stili da visualizzare e modificare:

#CQ td {
// defines the style for viewing
 }
#CQrte td {
 // defines the style for editing
 }

Specificare gli stili disponibili nell'elenco a comparsa

  1. Nella definizione del componente, passa al nodo <rtePlugins-node>/styles, come creato in Abilitazione del selettore a discesa Stile.

  2. Sotto il nodo styles, crea un nodo (detto anche styles) per contenere l’elenco che viene reso disponibile:

    • Nome styles
    • Tipo cq:WidgetCollection
  3. Crea un nodo sotto il styles nodo per rappresentare un singolo stile:

    • Nome, è possibile specificare il nome, ma deve essere adatto allo stile
    • Tipo nt:unstructured
  4. Aggiungi la proprietà cssName a questo nodo per fare riferimento alla classe CSS:

    • Nome cssName
    • Tipo String
    • Valore Il nome della classe CSS (senza un precedente '.'); ad esempio, cssClass anziché .cssClass)
  5. Aggiungi la proprietà text allo stesso nodo; definisce il testo visualizzato nella casella di selezione:

    • Nome text
    • Tipo String
    • Valore descrizione dello stile; nella casella di selezione a discesa Stile.
  6. Salva le modifiche.

    Ripeti i passaggi precedenti per ogni stile richiesto.

Configurare l’editor Rich Text per interruzioni di parole ottimali in giapponese

Autori che utilizzano Experience Manager per creare contenuti in lingua giapponese, è possibile applicare uno stile ai caratteri per evitare interruzioni di riga in cui non è necessaria un’interruzione. Questo permette agli autori di lasciare che le frasi si rompano nella posizione desiderata. Lo stile di questa funzionalità si basa sulla classe CSS predefinita nel foglio di stile CSS.

Per creare lo stile che gli autori possono applicare al testo giapponese, effettua le seguenti operazioni:

  1. Crea un nodo sotto il nodo degli stili. Vedi specificare uno stile.

    • Nome: jpn-word-wrap
    • Tipo: nt:unstructure
  2. Aggiungi la proprietà cssName al nodo per fare riferimento alla classe CSS. Questo nome di classe è un nome riservato per la funzione di ritorno a capo automatico in giapponese.

    • Nome: cssName
    • Tipo: String
    • Valore: jpn-word-wrap (senza una .)
  3. Aggiungi il testo della proprietà allo stesso nodo. Il valore è il nome dello stile visualizzato dagli autori durante la selezione dello stile.

    • Nome: text
      *Tipo:
      String
    • Valore: Japanese word-wrap
  4. Creare un foglio di stile e specificarne il percorso. Vedi specificare la posizione del foglio di stile. Aggiungere il contenuto seguente al foglio di stile. Modificate il colore di sfondo desiderato.

    .text span.jpn-word-wrap {
        display:inline-block;
    }
    .is-edited span.jpn-word-wrap {
        background-color: #ffddff;
    }
    

    Foglio di stile per rendere disponibile agli autori la funzione di ritorno a capo automatico per il giapponese

Configurare i formati paragrafo

Qualsiasi testo creato nell’editor Rich Text viene inserito all’interno di un tag blocco, con l’impostazione predefinita <p>. Attivando la funzione paraformat plug-in consente di specificare tag blocco aggiuntivi da assegnare ai paragrafi mediante un elenco a discesa di selezione. I formati paragrafo determinano il tipo di paragrafo assegnando il tag blocco corretto. L’autore può selezionarli e assegnarli utilizzando il selettore Formato. I tag di blocco di esempio includono, tra gli altri, il paragrafo standard <p> e le intestazioni <h1>, <h2>e così via.

ATTENZIONE

Questo plug-in non è adatto per contenuti con struttura complessa, ad esempio elenchi o tabelle.

NOTA

Se un tag di blocco, ad esempio un <hr> tag, non può essere assegnato a un paragrafo, non è un caso d’uso valido per un paraformat plug-in.

Quando il plug-in Formati paragrafo è attivato per la prima volta, non sono disponibili formati paragrafo predefiniti. L'elenco a comparsa è vuoto. Per fornire agli autori i formati di paragrafo, procedi come segue:

  • Abilita la Formato elenco di selettori a comparsa.
  • Specifica i tag blocco che possono essere selezionati come formati paragrafo dal menu a comparsa.

Per ulteriori riconfigurazioni, ad esempio per aggiungere altri formati, seguire solo la parte pertinente delle istruzioni.

Attiva il selettore a discesa Formato

Per abilitare paraformat plug-in, segui questi passaggi:

  1. Nel componente, accedi al nodo <rtePlugins-node>/paraformat. Crea i nodi se i nodi non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Crea il features sulla proprietà paraformat nodo:

    • Nome features
    • Tipo String
    • Valore * (asterisco)
NOTA

Se il plug-in non è configurato ulteriormente, i formati predefiniti abilitati sono Paragrafo ( <p>), Rubrica 1 ( <h1>, Titolo 2 ( <h2>, Rubrica 3 ( <h3>).

ATTENZIONE

Durante la configurazione dei formati paragrafo dell’editor Rich Text, non rimuovere il tag paragrafo <p> come opzione di formattazione. Se la <p> Il tag viene rimosso, quindi l’autore del contenuto non può selezionare il Formati paragrafo anche in presenza di formati aggiuntivi configurati.

Specificare i formati paragrafo disponibili

I formati paragrafo sono disponibili per la selezione tramite:

  1. Nella definizione del componente, passa al nodo <rtePlugins-node>/paraformat, come creato in Abilitazione del selettore a discesa del formato.

  2. Sotto la paraformat creare un nodo, per contenere l'elenco dei formati:

    • Nome formats
    • Tipo cq:WidgetCollection
  3. Crea un nodo sotto il formats nodo, contiene i dettagli di un singolo formato:

    • Nome, è possibile specificare il nome, ma deve essere adatto al formato (ad esempio, myParagraph, myheader1).
    • Tipo nt:unstructured
  4. A questo nodo, aggiungi la proprietà per definire il tag blocco utilizzato:

    • Nome tag

    • Tipo String

    • Valore Il tag di blocco per il formato; ad esempio: p, h1, h2, ecc.

      Non è necessario inserire le parentesi angolari di delimitazione.

  5. Allo stesso nodo aggiungere un'altra proprietà, affinché il testo descrittivo venga visualizzato nell'elenco a discesa:

    • Nome description
    • Tipo String
    • Valore Testo descrittivo per questo formato; ad esempio Paragrafo, Titolo 1, Titolo 2 e così via. Questo testo viene visualizzato nell'elenco di selezione Formato.
  6. Salva le modifiche.

    Ripetere i passaggi per ogni formato richiesto.

ATTENZIONE

Se si definiscono formati personalizzati, i formati predefiniti (<p>, <h1>, <h2>e <h3>) vengono rimosse. Ricrea <p> il formato predefinito.

Configurare caratteri speciali

In uno standard Experience Manager quando misctools il plug-in è abilitato per i caratteri speciali (specialchars) è immediatamente disponibile per l'uso una selezione predefinita; ad esempio, i simboli di copyright e marchio.

Puoi configurare l’editor Rich Text per rendere disponibile la selezione dei caratteri; definendo caratteri distinti o un'intera sequenza.

ATTENZIONE

L’aggiunta di caratteri speciali sostituisce la selezione predefinita. Se necessario, ridefinisci questi caratteri nella selezione.

Definire un singolo carattere

  1. Nel componente, accedi al nodo <rtePlugins-node>/misctools. Crea i nodi se i nodi non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Crea il features sulla proprietà misctools nodo:

    • Nome features

    • Tipo String[]

    • Valore specialchars

      o String / * se si applicano tutte le funzioni di questo plug-in)

  3. Sotto misctools crea un nodo per contenere le configurazioni dei caratteri speciali:

    • Nome specialCharsConfig
    • Tipo nt:unstructured
  4. Sotto specialCharsConfig crea un altro nodo per contenere l’elenco di caratteri:

    • Nome chars
    • Tipo nt:unstructured
  5. Sotto chars aggiungi un nodo per contenere una definizione di singolo carattere:

    • Nome è possibile specificare il nome, ma deve riflettere il carattere; per esempio, metà.
    • Tipo nt:unstructured
  6. A questo nodo aggiungi la seguente proprietà:

    • Nome entity
    • Tipo String
    • Valore la rappresentazione HTML del carattere richiesto; ad esempio, &189; per la frazione una metà.
  7. Salva le modifiche.

In CRXDE, una volta salvata la proprietà, viene visualizzato il carattere rappresentato. Vedi sotto l'esempio della metà. Ripeti i passaggi precedenti per rendere disponibili agli autori altri caratteri speciali.

In CRXDE, aggiungi un singolo carattere da rendere disponibile nella barra degli strumenti dell’editor Rich Text

Definire un intervallo di caratteri

  1. Utilizza i passaggi da 1 a 3 da Definire un singolo carattere.

  2. Sotto chars aggiungi un nodo per contenere la definizione dell'intervallo di caratteri:

    • Nome è possibile specificare il nome, ma deve riflettere l'intervallo di caratteri; per esempio, matite.
    • Tipo nt:unstructured
  3. Sotto questo nodo (denominato in base all'intervallo di caratteri speciale) aggiungi le due seguenti proprietà:

    • Nome rangeStart

      Tipo Long
      Valore la Unicode rappresentazione (decimale) del primo carattere dell’intervallo

    • Nome rangeEnd

      Tipo Long
      Valore la Unicode rappresentazione (decimale) dell’ultimo carattere dell’intervallo

  4. Salva le modifiche.

    Ad esempio, definisci un intervallo da 9998 - 10000 ti fornisce i seguenti caratteri.

    In CRXDE, definisci un intervallo di caratteri da rendere disponibile nell’editor Rich Text

    Figura: In CRXDE, definisci un intervallo di caratteri da rendere disponibile nell’editor Rich Text

    I caratteri speciali disponibili nell’editor Rich Text vengono visualizzati agli autori in una finestra a comparsa

Configurare gli stili di tabella

Gli stili vengono in genere applicati al testo, ma è possibile applicare un set separato di Stili anche a una tabella o a alcune celle della tabella. Tali stili sono disponibili per gli autori dalla casella di selezione Stile della finestra di dialogo Proprietà cella o Proprietà tabella. Gli stili sono disponibili quando si modifica una tabella all’interno di un componente Testo (o derivato) e non nel componente Tabella standard.

NOTA

È possibile definire stili per tabelle e celle solo per l’interfaccia classica.

NOTA

Le tabelle copiate e incollate nel componente RTE o dal componente RTE dipendono dal browser. Non è supportato come funzionalità integrata per tutti i browser. È possibile ottenere risultati variabili a seconda della struttura della tabella e del browser. Ad esempio, quando copi e incolla una tabella in un componente RTE in Mozilla Firefox nell’interfaccia classica e Touch, il layout della tabella non viene mantenuto.

  1. Nel componente passa al nodo <rtePlugins-node>/table. Crea i nodi se i nodi non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Crea il features sulla proprietà table nodo:

    • Nome features
    • Tipo String
    • Valore *
    NOTA

    Se non desideri abilitare tutte le funzionalità della tabella, puoi creare la features come:

    • Tipo String[]
    • Valore s) uno o entrambi i seguenti elementi, a seconda delle necessità:
    * `table` consentire la modifica delle proprietà della tabella; inclusi gli stili. * `cellprops` per consentire la modifica delle proprietà delle celle, inclusi gli stili.
  3. Definisci la posizione dei fogli di stile CSS in modo da farvi riferimento. Vedi Specifica della posizione del foglio di stile come quando si definisce stili per testo. La posizione può essere definita se hai definito altri stili.

  4. Sotto la table crea i seguenti nodi come richiesto:

    • Definizione degli stili per l’intera tabella (disponibile in Proprietà tabella):

      • Nome tableStyles
      • Tipo cq:WidgetCollection
    • Per definire gli stili per le singole celle (disponibile in Proprietà cella),

      • Nome cellStyles
      • Tipo cq:WidgetCollection
  5. Crea un nodo (sotto il tableStyles o cellStyles nodo a seconda dei casi) per rappresentare un singolo stile,

    • Nome è possibile specificare il nome, ma deve riflettere lo stile.
    • Tipo nt:unstructured
  6. In questo nodo creare le proprietà:

    • Per definire lo stile CSS a cui viene fatto riferimento,

      • Nome cssName
      • Tipo String
      • Valore il nome della classe CSS (senza un .ad esempio, cssClass anziché .cssClass)
    • Per definire un testo descrittivo da visualizzare nel selettore a comparsa,

      • Nome text
      • Tipo String
      • Valore il testo da visualizzare nell’elenco di selezione
  7. Salva tutte le modifiche.

Ripeti i passaggi precedenti per ogni stile richiesto.

Configurare intestazioni nascoste nelle tabelle per l’accessibilità

A volte è possibile creare tabelle di dati senza testo visivo in un’intestazione di colonna, partendo dal presupposto che lo scopo dell’intestazione sia determinato dalla relazione visiva della colonna con altre colonne. In questo caso, è necessario fornire un testo interno nascosto all’interno della cella di intestazione per consentire agli assistenti vocali e altre tecnologie per l’accessibilità di comprendere lo scopo della colonna.

Per migliorare l’accessibilità in tali scenari, l’editor Rich Text supporta celle di intestazione nascoste. Inoltre, fornisce le impostazioni di configurazione relative alle intestazioni nascoste nelle tabelle. Queste impostazioni consentono di applicare stili CSS sulle intestazioni nascoste nelle modalità di modifica e anteprima. Per aiutare gli autori a identificare le intestazioni nascoste nella modalità di modifica, includi nel codice i seguenti parametri:

  • hiddenHeaderEditingCSS: Specifica il nome della classe CSS applicata alla cella di intestazione nascosta quando viene modificato l’editor Rich Text.
  • hiddenHeaderEditingStyle: Specifica una stringa di stile applicata alla cella di intestazione nascosta quando viene modificato l’editor Rich Text.

Se si specificano sia il CSS che la stringa di stile nel codice, la classe CSS ha la precedenza sulla stringa di stile e può sovrascrivere eventuali modifiche di configurazione apportate dalla stringa di stile.

Per aiutare gli autori ad applicare CSS sulle intestazioni nascoste nella modalità di anteprima, puoi includere nel codice i seguenti parametri:

  • hiddenHeaderClassName: Specifica il nome della classe CSS applicata alla cella di intestazione nascosta in modalità anteprima.
  • hiddenHeaderStyle: Specifica una stringa di stile applicata alla cella di intestazione nascosta in modalità anteprima.

Se si specificano sia il CSS che la stringa di stile nel codice, la classe CSS ha la precedenza sulla stringa di stile e può sovrascrivere eventuali modifiche di configurazione apportate dalla stringa di stile.

Aggiungere dizionari per il controllo ortografia

Quando il plug-in per il controllo ortografia viene attivato, l’editor Rich Text utilizza dizionari per ogni lingua appropriata. Questi vengono quindi selezionati in base alla lingua del sito web, scegliendo la proprietà language della struttura secondaria o estraendo la lingua dall’URL; ad esempio. la /en/ il ramo è controllato come inglese, il /de/ come tedesco.

NOTA

Messaggio "Controllo ortografia non riuscito". viene visualizzato se viene eseguito un controllo per una lingua non installata.

Un’installazione di Experience Manager standard include i dizionari per:

  • Inglese americano (en_us)
  • Inglese (en_gb)
NOTA

I dizionari standard si trovano in /libs/cq/spellchecker/dictionaries, insieme ai file ReadMe appropriati. Non modificare i file.

Per aggiungere altri dizionari, se necessario, segui questi passaggi.

  1. Passa alla pagina https://extensions.openoffice.org/.

  2. Seleziona la lingua richiesta e scarica il file ZIP con le definizioni di ortografia. Estrarre il contenuto dell'archivio sul file system.

    ATTENZIONE

    Solo dizionari nel MySpell Sono supportati i formati per OpenOffice.org v2.0.1 o versioni precedenti. Poiché i dizionari ora sono file di archivio, si consiglia di verificare l’archivio dopo averlo scaricato.

  3. Individua i file .aff e .dic. Mantieni il nome del file in minuscolo. Ad esempio: de_de.aff e de_de.dic.

  4. Carica i file .aff e .dic nell'archivio all'indirizzo /apps/cq/spellchecker/dictionaries.

NOTA

Il controllo ortografico dell’editor Rich Text è disponibile su richiesta. Non viene eseguito automaticamente quando si inizia a digitare del testo.
Per eseguire il controllo ortografico, tocca o fai clic sul pulsante Controllo ortografia nella barra degli strumenti. L’editor Rich Text controlla l’ortografia delle parole ed evidenzia le parole con errori di ortografia.
Se si incorpora una modifica suggerita dal controllo ortografia, lo stato del testo cambia e le parole con un errore ortografico non vengono più evidenziate. Per eseguire il controllo ortografico, toccare/fare di nuovo clic sul pulsante Controllo ortografia.

Configurare le dimensioni della cronologia per le azioni di annullamento e ripristino

L’editor Rich Text consente agli autori di annullare o ripristinare alcune ultime modifiche. Per impostazione predefinita, nella cronologia sono memorizzate 50 modifiche. Puoi configurare questo valore come necessario.

  1. Nel componente passa al nodo <rtePlugins-node>/undo. Crea questi nodi se non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Sulla undo crea la proprietà:

    • Nome maxUndoSteps
    • Tipo Long
    • Valore il numero di passaggi di annullamento da salvare nella cronologia. Il valore predefinito è 50. Utilizzo 0 per disattivare completamente Annulla/Ripristina.
  3. Salva le modifiche.

Configurare le dimensioni della scheda

Quando si preme il carattere di tabulazione all’interno di un testo, viene inserito un numero predefinito di spazi; per impostazione predefinita sono presenti tre spazi unificatori e uno spazio.

Per definire la dimensione della scheda:

  1. Nel componente, accedi al nodo <rtePlugins-node>/keys. Crea i nodi se i nodi non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Sulla keys crea la proprietà:

    • Nome tabSize
    • Tipo String
    • Valore il numero di caratteri di spazio da utilizzare per il tabulatore.
  3. Salva le modifiche.

Imposta margine di rientro

Quando il rientro è abilitato (impostazione predefinita), è possibile definire le dimensioni del rientro:

NOTA

Questa dimensione del rientro è applicata solo ai paragrafi (blocchi) di testo; non incide sul rientro degli elenchi effettivi.

  1. Nel componente passa al nodo <rtePlugins-node>/lists. Crea questi nodi se non esistono. Per ulteriori dettagli, consulta attivare un plug-in.

  2. Sulla lists creare il nodo identSize parametro:

    • Nome: identSize
    • Tipo: Long
    • Valore: numero di pixel richiesti per il margine di rientro.

Configurare l’altezza dello spazio modificabile

Puoi definire l’altezza dello spazio modificabile visualizzato nella finestra di dialogo del componente. La configurazione è applicabile solo quando si utilizza l’editor Rich Text in una finestra di dialogo. La configurazione non modifica l'altezza della finestra di dialogo.

  1. In ../items/text nella definizione della finestra di dialogo del componente, crea una proprietà:

    • Nome height
    • Tipo Long
    • Valore l'altezza dell'area di lavoro di modifica in pixel.
  2. Salva le modifiche.

Configurazione di stili e protocolli per i collegamenti

Quando si aggiungono collegamenti in Experience Manager, puoi definire gli stili CSS da utilizzare e i protocolli da accettare automaticamente. Per configurare la modalità di aggiunta dei collegamenti in Experience Manager da un altro programma, definire le regole di HTML.

  1. Utilizzando CRXDE Lite, individua il componente di testo per il progetto.

  2. Crea un nodo allo stesso livello di <rtePlugins-node>, ovvero, crea il nodo sotto il nodo principale di <rtePlugins-node>:

    • Nome htmlRules
    • Tipo nt:unstructured
    NOTA

    La ../items/text node presenta la proprietà :

    • Nome xtype
    • Tipo String
    • Valore richtext

    La posizione del ../items/text può variare a seconda della struttura della finestra di dialogo. Due esempi: /apps/myProject>/components/text/dialog/items/text e /apps/<myProject>/components/text/dialog/items/panel/items/text.

  3. Sotto htmlRules, crea un nodo.

    • Nome links
    • Tipo nt:unstructured
  4. Sotto la links definisci le proprietà come richiesto:

    • Stile CSS per collegamenti interni:

      • Nome cssInternal
      • Tipo String
      • Valore il nome della classe CSS (senza un '.' precedente; ad esempio, cssClass anziché .cssClass)
    • Stile CSS per collegamenti esterni

      • Nome cssExternal
      • Tipo String
      • Valore il nome della classe CSS (senza un '.' precedente; ad esempio, cssClass anziché .cssClass)
    • Matrice valida protocolli compreso https://, https://, file://, mailto:e altri,

      • Nome protocols
      • Tipo String[]
      • Valore(s) uno o più protocolli
    • defaultProtocol (proprietà del tipo Stringa): Protocollo da utilizzare se l'utente non ne ha specificato esplicitamente uno.

      • Nome defaultProtocol
      • Tipo String
      • Valore(s) uno o più protocolli predefiniti
    • Definizione di come gestire l’attributo di destinazione di un collegamento. Crea un nodo:

      • Nome targetConfig
      • Tipo nt:unstructured

      Sul nodo targetConfig: definire le proprietà richieste:

      • Specifica la modalità di destinazione:

        • Nome mode

        • Tipo String)

        • Valore s) :

          • auto: significa che è stato scelto un target automatico

            (specificato dal targetExternal proprietà per collegamenti esterni o targetInternal per i collegamenti interni).

          • manual: non applicabile in questo contesto

          • blank: non applicabile in questo contesto

      • Destinazione dei collegamenti interni:

        • Nome targetInternal
        • Tipo String
        • Valore la destinazione per i collegamenti interni (da utilizzare solo quando la modalità è auto)
      • Destinazione dei collegamenti esterni:

        • Nome targetExternal
        • Tipo String
        • Valore la destinazione per i collegamenti esterni (utilizzata solo quando la modalità è auto).
  5. Salva tutte le modifiche.

In questa pagina