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
AEM as a Cloud Service
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 aem_cmp_library_text 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 sua 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 dell’editor Rich Text.
Solo le opzioni abilitate dalle configurazioni dell’interfaccia utente dell’editor Rich Text sono disponibili nel componente Testo.

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

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+U
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 è in AEM, immettete l’URL assoluto
      • I percorsi non assoluti vengono interpretati come relativi ad 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 attenuata 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.
  • Selezionate
    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. 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.
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.
Quando si utilizza la funzionalità replace, la stringa replace da sostituire deve essere immessa contemporaneamente alla stringa find. È comunque possibile fare clic su find per cercare la stringa prima di sostituirla. Se la stringa di sostituzione viene immessa dopo aver fatto clic su Trova, la ricerca viene reimpostata all’inizio del testo.

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 - Spazio tra 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
​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.

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 Utilizzo del livello dati client Adobe con i componenti core 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 di stile di AEM.