Show Menu
TOPICS×

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 modifica 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, le opzioni di formattazione del testo, come titoli, caratteri speciali e stili di paragrafo, possono essere configurate per il modello per l'autore del contenuto.

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.
La tabella seguente elenca 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.3
AEM 6.4
AEM 6.5
v2
Compatibile
Compatibile
Compatibile
Compatibile
Compatibile
Compatibile
Per ulteriori informazioni sulle versioni e sulle versioni dei componenti core, consulta il documento Versioni dei componenti core.

Output componente di esempio

Per provare il componente di testo e per visualizzare esempi delle relative opzioni di configurazione, nonché l’output HTML e JSON, visita la Libreria text.html componenti.

Dettagli tecnici

La documentazione tecnica più recente sul componente Testo è disponibile su GitHub .
Per ulteriori informazioni sullo sviluppo dei componenti core, consulta la documentazione per lo sviluppatore di componenti core.

Il componente Testo e l’Editor Rich Text

Il componente di testo Componenti di base sfrutta l’editor Rich Text (RTE) di 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 configurazione e offre una serie di opzioni. Per ulteriori informazioni sulla configurazione dell’editor Rich Text, consultate gli 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 RTE.
Only options enabled by UI configurations of the RTE are available by in the Text Component. rich-text-editor.html

Edit Dialog

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

Used to apply italicized formatting to selected text or italicize text entered after the cursor.
Ctrl+I can be used as a keyboard shortcut.

Sottolineato

Used to apply underlined formatting to selected text or underline text entered after the cursor.
Ctrl+U
può essere utilizzato come scelta rapida da tastiera.

Pedice

Used to format selected text or text entered after the cursor as subscript.

Apice

Used to format selected text or text entered after the cursor as superscript.

Incolla come testo

Pastes any copied text as plain text without any formatting.
When selecting this option a window opens where the text can be pasted as plain text with no formatting as a preview before it is inserted into the text. Accept by tapping or clicking the check mark, cancel by tapping or clicking the x.

Incolla da Word

When selecting this option a window opens where the text can be pasted maintaining its formatting as a preview before it is inserted into the text. Accept by tapping or clicking the check mark, cancel by tapping or clicking the x.

Collegamento ipertestuale

Utilizzare questa opzione per convertire il testo selezionato in un collegamento ipertestuale o per modificare un collegamento già definito. This option is only active when text is already selected and opens a window with additional options for setting the link.
  • Enter the location
    • Use the Open Selection Dialog to choose a path in AEM
    • If the link is not within AEM, enter the absolute URL (non-absolute paths are interpreted as relative to 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 desiderate eseguire una corrispondenza esatta in base al caso, selezionate 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 desiderate eseguire una corrispondenza esatta in base al caso, selezionate 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. Fate di nuovo clic sul pulsante
Trova
nella finestra di dialogo disattivata per cercare l'occorrenza successiva oppure fate clic sul pulsante
Sostituisci
per sostituire il testo evidenziato e corrispondente. Il pulsante
Sostituisci
è attivo solo una volta raggiunta una corrispondenza.
Selezionate
Sostituisci tutto
per sostituire tutte le occorrenze del testo contemporaneamente.

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

Used to format the selected text as a bulleted list or begin the insertion of a bulleted list after the cursor.
Per terminare un elenco puntato, toccate o fate di nuovo clic sul pulsante
Bullet
oppure immettete due ritorni a capo.

Numerato

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, toccate o fate di nuovo clic sul pulsante
Numerato
oppure immettete due ritorni a capo.

Rientro negativo

Used to decrease the indentation level of the selected text or text entered after the cursor.
Only active if the selected text or position of the cursor is already indented.

Rientro

Used to increase the indentation level of the selected text or text entered after the cursor.

Tabella

Used to insert a table into the text. Selezionando questa opzione si apre una finestra per specificare i dettagli della tabella.
  • Columns The number of columns of the table (required)
  • Rows The number of rows of the table (required)
  • Larghezza
    La larghezza della tabella
  • Altezza
    L'altezza della tabella
  • Cell padding The space around the cell content
  • Cell spacing The space between cells
  • Border The weight of the border lines of the table
  • If for the header of the table:
    • La prima riga deve essere utilizzata
    • Utilizzare la prima colonna
    • The first row and first column should be used
    • 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 sorgente 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
Sorgente modifica
per tornare alla visualizzazione formattata.
Come sempre con l'accesso a HTML non elaborato, occorre prestare attenzione quando si utilizza l'opzione di modifica origine!
L'HTML immesso tramite Modifica origine viene analizzato per rilevare i rischi XSS e gli script inseriti vengono rimossi e non verranno visualizzati nella pagina risultante. Tuttavia, l’HTML con formato non corretto immesso in
Modifica
origine può interrompere il modello per la pagina, dando luogo a una formattazione imprevista o rendendo la pagina risultante inutilizzabile.
Poiché l'HTML immesso tramite
Source Edit
(Modifica
origine) è sottoposto a scansione per individuare rischi XSS e per rimuovere automaticamente quelli trovati, il contenuto effettivo persistente può variare da quello immesso in
Source Edit (Modificaorigine). Per questo motivo, per salvare le modifiche effettuate tramite Modifica sorgente, prima di salvare è necessario uscire da Modifica sorgente per visualizzare il testo nell’editor normale.

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.
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.

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 Plug-in consente di abilitare e disabilitare 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
  • Modifica origine

Formattazione

Le seguenti opzioni di formattazione possono essere attivate o disattivate per il componente.
  • Tabella
  • Elenchi
  • Allineamento
  • Grassetto, corsivo, sottolineato
  • Collegamenti
  • 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.

Configurazione di 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 di stile di AEM.