Componente Testo e-mail

Il componente Testo e-mail è un componente per la modifica e la composizione come testo formattato che offre funzioni di modifica diretta.

Utilizzo

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

  • La finestra di dialogo per la modifica offre funzioni di modifica in linea con opzioni limitate. Le funzionalità complete sono disponibili nella finestra di dialogo di modifica a schermo intero.
  • La finestra di dialogo per la progettazione consente di configurare le opzioni di formattazione del testo, come intestazioni, caratteri speciali e stili di paragrafo, per il modello utilizzabile dall’autore del contenuto.

Versione e compatibilità

La versione corrente del componente Testo e-mail è la v1, introdotta con la versione X dei Componenti core e-mail a ottobre 2022, ed è quella descritta in questo documento.

La tabella che segue descrive tutte le versioni supportate del componente, le versioni di AEM con cui le versioni del componente sono compatibili e i collegamenti alla documentazione delle versioni precedenti.

Versione del componente AEM 6.5 AEM as a Cloud Service
v1 Compatibile Compatibile

Per ulteriori informazioni sulle versioni e sugli aggiornamenti dei Componenti core, consulta il documento Versioni dei Componenti core e-mail.

Esempio di output del componente

Per avere un’idea del componente Testo e vedere esempi delle opzioni di configurazione e dell’output HTML e JSON, visita la libreria dei componenti.

Dettagli tecnici

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

Per ulteriori informazioni sullo sviluppo di Componenti core, vedi la documentazione per gli sviluppatori di Componenti core.

Il componente Testo e-mail e l’editor Rich Text

Il componente core Testo e-mail utilizza l’editor Rich Text di AEM. L’editor Rich Text offre agli autori di contenuto un’ampia gamma di funzionalità per modificare il contenuto di testo. La configurazione dell’editor Rich Text è molto flessibile e offre diverse opzioni. Ulteriori dettagli sulla configurazione dell’editor Rich Text sono disponibili negli articoli Configurazione dell’editor Rich Text e Configurazione dei plug-in dell’editor Rich Text.

Il resto di questo documento illustra la configurazione standard del componente Testo e-mail con la configurazione standard dell’editor Rich Text.

NOTA

Nel componente Testo e-mail sono disponibili solo le opzioni abilitate dalle Configurazioni dell’interfaccia utente dell’editor Rich Text.

Finestra di dialogo per la modifica

Finestra di dialogo per la modifica del componente Testo

Opzioni di formattazione

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

Grassetto

Icona Grassetto

Consente di applicare il grassetto al testo selezionato o al testo immesso dopo il cursore.

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

Corsivo

Icona Corsivo

Consente di applicare il corsivo al testo selezionato o al testo immesso dopo il cursore.

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

Sottolineato

Icona Sottolineato

Consente di applicare la sottolineatura al testo selezionato o al testo immesso dopo il cursore.

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

Pedice

Icona Pedice

Consente di formattare come pedice il testo selezionato o il testo immesso dopo il cursore.

Apice

Icona Apice

Consente di formattare come apice il testo selezionato o il testo immesso dopo il cursore.

Incolla testo semplice

Icona Incolla testo semplice

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

Quando si seleziona questa opzione, viene visualizzata una finestra in cui il testo copiato può essere incollato come testo normale senza formattazione in anteprima, prima di essere effettivamente inserito nel testo. Per accettare, tocca o fai clic sul segno di spunta, per annullare tocca o fai clic sulla x.

Incolla come esempio di testo

Incolla da Word

Icona Incolla da Word

Quando si seleziona questa opzione, viene visualizzata una finestra in cui il testo copiato può essere incollato con la formattazione originale in anteprima, prima di essere effettivamente inserito nel testo. Per accettare, tocca o fai clic sul segno di spunta, per annullare tocca o fai clic sulla x.

Incolla da esempio di Word

Collegamento ipertestuale

Icona Collegamento ipertestuale

Questa opzione consente di convertire il testo selezionato in un collegamento ipertestuale o modificare un collegamento già definito. Questa opzione apre una finestra contenente opzioni aggiuntive per impostare il collegamento.

Esempio di collegamento ipertestuale

  • Immettere il percorso
    • Utilizza la finestra di dialogo Apri selezione per scegliere un percorso in AEM
    • Se il collegamento non è in AEM, utilizza l’URL assoluto
      • I percorsi non assoluti vengono interpretati come relativi ad AEM
  • Immetti un testo descrittivo alternativo per il collegamento
  • Seleziona il comportamento del collegamento
    • Destinazione
    • Stessa scheda
    • Nuova scheda
    • Frame principale
    • Frame superiore

Tocca o fai clic sul segno di spunta per applicare il collegamento o sulla x per annullare.

Scollega

Icona Scollega

Questa opzione consente di rimuovere un collegamento già applicato al testo selezionato. Questa opzione è attiva solo se è già selezionato un collegamento.

Ancoraggio

Icona ancoraggio

Utilizza questa opzione per inserire un ancoraggio nel testo.

Trova

Icona Trova

Questa opzione consente di cercare nel testo l’occorrenza di una stringa di testo specificata. Selezionando questa opzione, si apre una finestra per specificare le opzioni di ricerca.

Esempio dell’opzione Trova

Inserisci il testo da cercare e tocca o fai clic su Trova per iniziare la ricerca. Tocca o fai clic sulla x per annullare.
Se vuoi avere una corrispondenza esatta di maiuscole/minuscole, seleziona l’opzione Rispetta maiuscole/minuscole prima di avviare la ricerca.
Se viene trovata una corrispondenza, questa viene evidenziata e la finestra di dialogo di ricerca viene sfumata. Tocca o fai di nuovo clic sul pulsante Trova nella finestra di dialogo sfumata per cercare l’occorrenza successiva.

Esempio di occorrenza trovata

Se non vengono trovate altre occorrenze, viene visualizzato un messaggio e la ricerca riparte dall’inizio del testo.

Esempio di nessun’altra occorrenza trovata

Sostituisci

Icona Sostituisci

Questa opzione consente di 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 per specificare le opzioni di ricerca e sostituzione.

Esempio dell’opzione Sostituisci

Immettere il testo da cercare e il testo con cui deve essere sostituito.

  • Tocca o fai clic su Trova per iniziare la ricerca. Tocca o fai clic sulla x per annullare.
  • Se vuoi avere una corrispondenza esatta di maiuscole/minuscole, seleziona l’opzione Rispetta maiuscole/minuscole prima di avviare la ricerca.
  • Seleziona 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 sfumata. Fai nuovamente clic sul pulsante Trova nella finestra di dialogo sfumata per cercare l’occorrenza successiva oppure seleziona il pulsante Sostituisci per sostituire il testo evidenziato. Il pulsante Sostituisci è attivo solo una volta trovata 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. Ciò consente all’autore di rivedere il testo che verrà sostituito.

NOTA

Quando si utilizza la funzionalità Sostituisci, la stringa da sostituire 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.

Annulla

Icona Annulla

Utilizzato per annullare l’ultima modifica nell’editor Rich Text.

Ripristina

Icona Ripristina

Utilizzato per annullare una modifica annullata utilizzando l’icona Annulla.

Allineato a sinistra

Icona Allineato a sinistra

Consente di allineare il testo al margine sinistro.

Centrato

Icona Centrato

Consente di centrare il testo.

Allineato a destra

Icona Allineato a destra

Consente di allineare il testo al margine destro.

Punto elenco

Icona Punto elenco

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, tocca o fai clic nuovamente sul pulsante Punto elenco oppure immetti due ritorni a capo.

Numero

Icona Numero

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

Per terminare un elenco numerato, tocca o fai clic nuovamente sul pulsante Numero oppure immetti due ritorni a capo.

Riduci rientro

Icona Riduci rientro

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

L’opzione è attiva solo se il testo selezionato o la posizione del cursore è già rientrata.

Rientro

Icona Rientro

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

Tabella

Icona Tabella

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

Esempio di 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: lo spazio intorno al contenuto della cella
  • Spaziatura celle: lo spazio tra le celle
  • Bordo: lo spessore delle linee dei bordi della tabella
    • Per l’intestazione della tabella:
      • Utilizza la prima riga
      • Utilizza la prima colonna
      • Utilizza la prima riga e la prima colonna
      • In alternativa, non utilizzare alcuna intestazione
  • Didascalia: la didascalia della tabella

Immagine

Icona immagine

Utilizzato per allineare un’immagine inserita.

Controllo ortografico

Icona Controllo ortografico

Consente di verificare l’ortografia del testo. Eventuali errori di ortografia appaiono sottolineati con linee tratteggiate rosse.

Ulteriori dettagli sul controllo ortografico e sulla personalizzazione dei dizionari del controllo ortografico sono disponibili nel documento Configurazione dei plug-in dell’editor RTF.

Caratteri speciali

Icona Caratteri speciali

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

Esempio di caratteri speciali

Tocca o fai clic sul carattere desiderato per inserirlo nel testo dopo il cursore. Si possono inserire più caratteri. Tocca o fai clic sulla x per chiudere la finestra per selezione.

Modifica origine

Icona Modifica origine

Consente di visualizzare e modificare l’origine HTML del testo.

Per modificare il testo dalla vista formattata, tocca o fai clic sull’icona Modifica origine per visualizzare il codice HTML. In questa modalità, tutte le altre opzioni di formattazione sono disabilitate. Tocca o fai clic di nuovo sull’icona Modifica origine per tornare alla vista formattata.

ATTENZIONE

Come sempre quando si accede al codice HTML, utilizza l’opzione Modifica origine con molta attenzione!

Il codice HTML immesso tramite l’opzione Modifica origine viene analizzato per rilevare eventuali rischi XSS e tutti gli script inseriti vengono rimossi e non verranno visualizzati nella pagina risultante. Tuttavia, il codice HTML non corretto eventualmente immesso tramite Modifica origine può alterare il modello della pagina, causando formattazioni impreviste e rendendo inutilizzabile la pagina risultante.

NOTA

Poiché il codice HTML immesso tramite l’opzione Modifica origine viene analizzato per rilevare i rischi XSS e tutti gli script e rimuove automaticamente quelli trovati, il contenuto effettivo rimanente potrebbe variare rispetto a quello immesso in Modifica origine. Per questo motivo, per salvare le modifiche effettuate tramite Modifica origine, è necessario prima uscire da Modifica origine per visualizzare il testo nell’editor normale prima di salvarlo.

Formato paragrafo

Icona Formato paragrafo

Consente di formattare come paragrafo il testo selezionato o il testo inserito dopo il cursore. Selezionando questa opzione si apre un menu a discesa dal quale si può selezionare il formato del paragrafo.

Esempio di formato del paragrafo

Seleziona variabile di Adobe Campaign

Icona Seleziona variabile di Adobe Campaign

Apre la finestra di dialogo Seleziona variabile di Adobe Campaign per inserire il contenuto dinamico da Adobe Campaign.

Modifica in linea

È possibile modificare anche il componente testo in linea. Per la modifica in linea, seleziona il componente Testo e-mail nella pagina del contenuto.

Selezionare il componente Testo e-mail

Quindi tocca o fai clic sull’icona Modifica sulla barra degli strumenti che compare sul componente. La barra degli strumenti cambia e presenta alcune opzioni per la formattazione del testo (incluso l’accesso all’opzione Seleziona variabile di Adobe Campaign) e puoi modificare il testo in linea.

Esempio di modifica in linea

Tocca o fai clic sul segno di spunta nella barra degli strumenti per salvare le modifiche o sulla X per eliminarle.

A causa dei limiti di spazio, non tutte le opzioni di formattazione sono disponibili in linea. Per visualizzare tutte le opzioni, passa alla modalità a schermo intero.

Impostazione di un ID

Questa opzione consente di controllare l’identificatore univoco del componente nell’HTM.

  • Se non specificato, viene generato automaticamente un ID univoco reperibile sulla pagina risultante.
  • Se l’ID viene specificato, è responsabilità dell’autore accertarsi che sia univoco.
  • La modifica dell’ID può avere un impatto sulle CSS.

Finestra di dialogo per progettazione

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

Scheda Plug-in

La scheda Plug-in viene utilizzata per abilitare e disattivare varie opzioni di formattazione del testo disponibili per gli autori di contenuti.

Funzioni

Funzioni della finestra di dialogo per progettazione

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

  • Incolla testo semplice
  • Incolla da Word
  • Trova e sostituisci
  • Annulla e ripristina
  • Controllo ortografico
  • Opzioni di modifica per le immagini inserite
  • Modifica origine HTML

Formattazione

Opzione Formattazione della finestra di dialogo per progettazione

Per il componente è possibile attivare o disattivare le seguenti opzioni di formattazione.

  • Tabella
  • Elenchi (punto elenco, numero, rientro, riduci rientro)
  • Allineamento (a sinistra, a destra, centrato)
  • Grassetto, corsivo, sottolineato
  • Collegamento (e scollegamento)
  • Apice/pedice

Stili paragrafo

Opzione Stili di paragrafo della finestra di dialogo per Progettazione

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

  • Tocca o fai clic sul pulsante Aggiungi per inserire un nuovo stile.
  • Immetti il codice dello stile e una descrizione da visualizzare nella finestra di dialogo per modifica.
  • Per rimuovere uno stile, tocca o fai clic sul pulsante Elimina.
  • Per cambiare l’ordine dei formati, tocca o fai clic e trascina le maniglie.

Caratteri speciali

Opzione Caratteri speciali della finestra di dialogo per progettazione

L’opzione per l’inserimento di caratteri speciali può essere attivata o disattivata per il componente. Quando è attivata, è possibile definire i caratteri consentiti.

  • Tocca o fai clic sul pulsante Aggiungi per inserire un nuovo carattere.
  • Immetti il codice HTML del carattere e una descrizione da visualizzare nella finestra di dialogo per modifica.
  • Per rimuovere un carattere, tocca o fai clic sul pulsante Elimina.
  • Per cambiare l’ordine dei caratteri, tocca o fai clic e trascina le maniglie.

Scheda Stili

Il componente Testo e-mail supporta il sistema di stili di AEM.

In questa pagina