Componente testo

Il componente di base Testo è un componente RTF per la modifica e la composizione di testo che supporta la modifica diretta.

Utilizzo

Il componente Testo offre un potente editor Rich Text che consente di modificare facilmente il testo in un editor semplificato e in linea e in un formato a schermo intero.

La finestra di dialogo di modifica offre funzioni di editing in linea con opzioni limitate e funzionalità complete disponibili nella finestra di dialogo di modifica a schermo intero. Utilizzando la finestra di dialogo di progettazione progettazione, è possibile configurare per il modello le opzioni di formattazione del testo come titoli, caratteri speciali e stili di paragrafo.

Versione e compatibilità

La versione corrente del componente Testo è v2, introdotta con la release 2.0.0 dei componenti core nel gennaio 2018, ed è descritta in questo documento.

Nella tabella seguente sono elencate tutte le versioni supportate del componente, le versioni AEM con cui sono compatibili le versioni del componente e i collegamenti alla documentazione delle versioni precedenti.

Versione componente	AEM 6.4	AEM 6.5	AEM as a Cloud Service
v2	Compatibile	Compatibile	Compatibile
v1	Compatibile	Compatibile	-

Per ulteriori informazioni sulle versioni e sulle versioni dei componenti core, consultare il documento Versioni dei componenti core.

Esempio di output del componente

Per provare il componente di testo e vedere esempi delle relative opzioni di configurazione, nonché l'output HTML e JSON, visitare la Libreria componenti.

Dettagli tecnici

La documentazione tecnica più recente sul componente Testo è disponibile su GitHub.

Ulteriori dettagli sullo sviluppo di componenti core sono disponibili nella documentazione per lo sviluppo di componenti core.

Il componente Testo e l'Editor Rich Text

Il componente di testo Componenti di base sfrutta l’editor Rich Text (RTE) AEM. L’editor Rich Text offre agli autori dei contenuti un’ampia gamma di funzionalità per la modifica del contenuto testuale. L'editor Rich Text è molto flessibile nella sua configurazione e offre una serie di opzioni. Ulteriori dettagli sulla configurazione dell'editor Rich Text sono disponibili negli articoli Configurare l'editor Rich Text e Configurare i plug-in Editor Rich Text.

Il resto di questo articolo illustra la configurazione standard del componente di testo Componenti di base con la configurazione standard dell’editor Rich Text.

Finestra di dialogo Modifica

La finestra di dialogo di modifica offre gli strumenti di formattazione RTF standard che l’utente si aspetta di utilizzare per comporre del testo.

Grassetto

Utilizzato per applicare la formattazione in grassetto al testo selezionato o per formattare il testo in grassetto immesso dopo il cursore.

Ctrl+ B può essere utilizzato come scelta rapida da tastiera.

Corsivo

Utilizzato per applicare la formattazione in corsivo al testo selezionato o per personalizzare il testo immesso dopo il cursore.

Ctrl+ I può essere utilizzato come scelta rapida da tastiera.

Sottolineato

Utilizzato per applicare la formattazione sottolineata al testo selezionato o al testo sottolineato immesso dopo il cursore.

Ctrl+ Ucan può essere utilizzato come scelta rapida da tastiera.

Pedice

Utilizzato per formattare il testo o il testo selezionato immesso dopo il cursore come pedice.

Apice

Utilizzato per formattare il testo o il testo selezionato immesso dopo il cursore come apice.

Incolla come testo

Incolla tutto il testo copiato come testo normale senza alcuna formattazione.

Quando si seleziona questa opzione, si apre una finestra in cui il testo può essere incollato come testo normale senza formattazione come anteprima prima di essere inserito nel testo. Accetta toccando o facendo clic sul segno di spunta, annulla toccando o facendo clic sulla x.

Incolla da Word

Quando si seleziona questa opzione, si apre una finestra in cui è possibile incollare il testo, mantenendo la formattazione come anteprima prima di inserirlo nel testo. Accetta toccando o facendo clic sul segno di spunta, annulla toccando o facendo clic sulla x.

Collegamento ipertestuale

Utilizzare questa opzione per convertire il testo selezionato in un collegamento ipertestuale o per modificare un collegamento già definito. Questa opzione è attiva solo quando il testo è già selezionato e apre una finestra con opzioni aggiuntive per impostare il collegamento.

• Immettere il percorso

  • Utilizzare la finestra di dialogo Apri selezione per scegliere un percorso in AEM
  • Se il collegamento non è all’interno di AEM, immettete l’URL assoluto
    • I percorsi non assoluti vengono interpretati come relativi a AEM

• Immettere testo descrittivo alternativo per il collegamento

• Seleziona il comportamento del collegamento

  • Destinazione
  • Stessa scheda
  • Nuova scheda
  • Frame principale
  • Frame superiore

  Toccate o fate clic sul segno di spunta per applicare il collegamento o sulla x per annullare.

Scollega

Utilizzare questa opzione per rimuovere un collegamento già applicato al testo selezionato. Questa opzione è attiva solo se è già selezionato un collegamento.

Trova

Utilizzare questa opzione per cercare nel testo l'occorrenza di una stringa di testo specificata. Selezionando questa opzione si apre una finestra per specificare le opzioni di ricerca.

Immettere il testo per il quale si desidera eseguire la ricerca e toccare o fare clic su Trova per iniziare la ricerca. Toccate o fate clic sulla x per annullare.
Se si desidera eseguire una corrispondenza esatta in base al caso, selezionare l'opzione Maiuscole/minuscole prima di avviare la ricerca.
Se viene trovata una corrispondenza, questa viene evidenziata e la finestra di dialogo di ricerca viene disattivata. Toccate o fate di nuovo clic sul pulsante Trova nella finestra di dialogo disattivata per cercare l'occorrenza successiva.

Se non vengono trovate altre occorrenze, verrà visualizzato un messaggio e la ricerca verrà riavviata dall'inizio del testo.

Sostituisci

Utilizzare questa opzione per cercare nel testo le occorrenze di una stringa di testo specificata e sostituire le corrispondenze con un'altra stringa. Selezionando questa opzione si apre una finestra in cui specificare le opzioni di ricerca e sostituzione.

Immettere il testo per il quale si desidera eseguire la ricerca e il testo con cui sostituire il testo.

• Toccate o fate clic su Trova per iniziare la ricerca. Tocca o fai clic sulla x per annullare.
• Se si desidera eseguire una corrispondenza esatta in base al caso, selezionare l'opzione Maiuscole/minuscole prima di avviare la ricerca.
• Selezionare Sostituisci tutto per sostituire tutte le occorrenze del testo contemporaneamente.

Se viene trovata una corrispondenza, questa viene evidenziata e la finestra di dialogo di ricerca viene disattivata. Fare di nuovo clic sul pulsante Trova nella finestra di dialogo disattivata per cercare l'occorrenza successiva oppure selezionare il pulsante Sostituisci per sostituire il testo evidenziato e corrispondente. Tenere presente che il pulsante Replace è attivo solo una volta raggiunta una corrispondenza.

La finestra di dialogo Trova e sostituisci diventa trasparente quando si fa clic su Trova e diventa opaca quando si fa clic su Sostituisci. Questo consente all’autore di rivedere il testo che verrà sostituito dall’autore.

Allinea testo a sinistra

Utilizzato per allineare il testo al margine sinistro.

Testo centrato

Utilizzato per centrare il testo.

Allinea testo a destra

Utilizzato per allineare il testo al margine destro.

Proiettile

Consente di formattare il testo selezionato come elenco puntato o di iniziare l'inserimento di un elenco puntato dopo il cursore.

Per terminare un elenco puntato, toccate o fate di nuovo clic sul pulsante Bullet oppure immettete due ritorni a capo.

Numerato

Utilizzato per formattare il testo selezionato come elenco numerato o per iniziare l'inserimento di un elenco numerato dopo il cursore.

Per terminare un elenco numerato, toccate o fate di nuovo clic sul pulsante Numerato oppure immettete due ritorni a capo.

Rientro negativo

Consente di ridurre il livello di rientro del testo o del testo selezionato immesso dopo il cursore.

Attiva solo se il testo o la posizione selezionati del cursore sono già rientrati.

Rientro

Utilizzato per aumentare il livello di rientro del testo o del testo selezionato immesso dopo il cursore.

Tabella

Utilizzato per inserire una tabella nel testo. Selezionando questa opzione si apre una finestra per specificare i dettagli della tabella.

• Colonne - Il numero di colonne della tabella (obbligatorio)
• Righe - Il numero di righe della tabella (obbligatorio)
• Larghezza - La larghezza della tabella
• Altezza - L'altezza della tabella
• Margine celle - Spazio intorno al contenuto della cella
• Spaziatura celle - Lo spazio tra le celle
• Bordo - Lo spessore delle linee dei bordi della tabella
  • Se per l’intestazione della tabella:
    • La prima riga deve essere utilizzata
    • Utilizzare la prima colonna
    • Utilizzare la prima riga e la prima colonna
    • Oppure non utilizzare alcuna intestazione.
• Didascalia - La didascalia della tabella

Controllo ortografia

Utilizzato per il controllo dell'ortografia del contenuto di testo. Eventuali errori ortografici sono sottolineati con linee rosse rotte.

Ulteriori dettagli sul controllo ortografia e la personalizzazione dei dizionari di controllo ortografia sono disponibili nel documento Configurare i plug-in Editor Rich Text.

Caratteri speciali

Utilizzato per inserire caratteri speciali nel testo. Selezionando questa opzione si apre una finestra in cui vengono visualizzati i caratteri disponibili.

Toccate o fate clic sul carattere desiderato per inserirlo nel testo dopo il cursore. È possibile inserire più caratteri. Toccate o fate clic sulla x per chiudere la finestra di selezione.

Modifica origine

Utilizzato per visualizzare e modificare l'origine HTML del testo.

Toccate o fate clic sull'icona Modifica origine per cambiare il contenuto del testo dalla visualizzazione formattata per visualizzare l'HTML non elaborato. In questa modalità, tutte le altre opzioni di formattazione sono disattivate. Toccate o fate di nuovo clic sull'icona Modifica origine per tornare alla visualizzazione formattata.

Formato paragrafo

Utilizzato per applicare la formattazione del paragrafo al testo selezionato o al testo inserito dopo il cursore. Selezionando questa opzione si apre un menu a discesa dal quale è selezionato il formato del paragrafo.

Modifica in linea

Anche il componente di testo può essere modificato in linea, ma a causa dei limiti di spazio, non tutte le opzioni di formattazione sono disponibili in linea. Per visualizzare tutte le opzioni, passare alla modalità a schermo intero.

Impostazione e ID

Questa opzione consente di controllare l'identificatore univoco del componente nell'HTML e nel Livello dati.

• Se lasciato vuoto, viene generato automaticamente un ID univoco che può essere trovato esaminando la pagina risultante.
• Se viene specificato un ID, è responsabilità dell’autore assicurarsi che sia univoco.
• La modifica dell’ID può avere un impatto su CSS, JS e tracciamento dei livelli di dati.

Finestra di dialogo Progettazione

La finestra di dialogo Progettazione consente all'autore del modello di definire le opzioni di formattazione del testo disponibili per gli autori del contenuto.

Scheda Plugin

La scheda Plugins viene utilizzata per attivare e disattivare le varie opzioni di formattazione del testo disponibili per gli autori del contenuto.

Funzioni

Le seguenti funzioni possono essere attivate o disattivate per il componente.

• Incolla testo normale
• Passato da parola
• Trova e sostituisci
• Controllo ortografia
• Opzioni di modifica delle immagini inserite
• Modifica sorgente HTML

Formattazione

Le seguenti opzioni di formattazione possono essere attivate o disattivate per il componente.

• Tabella
• Elenchi (elenco, numero, rientro, rientro)
• Allineamento (sinistra, destra, centrato)
• Grassetto, corsivo, sottolineato
• Collegamento (e scollegamento)
• Pedice

Stili paragrafo

Gli stili di paragrafo possono essere attivati o disattivati per il componente. Quando attivato, è possibile definire i formati consentiti.

• Toccate o fate clic sul pulsante Aggiungi per inserire un nuovo stile.
• Immettete il codice dello stile e una descrizione che verrà visualizzata nella finestra di dialogo di modifica.
• Per rimuovere uno stile, toccate o fate clic sul pulsante Elimina.
• Per ridisporre l'ordine dei formati, toccate o fate clic e trascinate le maniglie.

Caratteri speciali

L’opzione per l’inserimento di caratteri speciali può essere attivata o disattivata per il componente. Se attivati, i caratteri consentiti possono essere definiti.

• Toccate o fate clic sul pulsante Aggiungi per inserire un nuovo carattere.
• Immettete il codice HTML del carattere e una descrizione che verrà visualizzata nella finestra di dialogo di modifica.
• Per rimuovere un carattere toccate o fate clic sul pulsante Elimina.
• Per riordinare i caratteri, toccate o fate clic e trascinate le maniglie.

Scheda Stili

Il componente Testo supporta il sistema AEM stile.