Tag di markup HTML supportati nel documento di record

Quali sono le implicazioni di questo riferimento?

AEM Forms ora supporta i tag di markup HTML nei campi Rich Text durante la generazione di PDF del documento record (DoR). Questa guida spiega quali tag di markup HTML puoi utilizzare in modo sicuro in Adaptive Forms e come vengono riprodotti nei documenti generati.

Se ai moduli si aggiungono contenuti in formato Rich Text (ad esempio in grassetto, elenchi o collegamenti), è importante capire quali tag sono supportati e quali limitazioni possono avere. Questo riferimento consente di scegliere i tag appropriati per garantire che il contenuto venga visualizzato correttamente e rimanga accessibile nel documento di record.

Prima di iniziare

Prerequisiti

Dovresti conoscere:

  • Sintassi di markup HTML di base
  • Nozioni di base sul documento di record
  • Principi di accessibilità e linee guida WCAG
  • Requisiti di accessibilità di PDF
  • Componenti del modulo adattivo che accettano il markup HTML

Considerazioni

Il documento di record (DoR) può essere un PDF con tag, il che contribuisce a garantire l’accessibilità e la struttura corretta per le tecnologie per l’accessibilità. Per abilitare l'output di PDF con tag, impostare la proprietà XCI config/present/pdf/tagged su true. Dopo aver generato il PDF, è importante verificare che i tag di accessibilità siano applicati correttamente. È possibile utilizzare Adobe Acrobat per verificare i tag di accessibilità e assicurarsi che il documento soddisfi gli standard di accessibilità.

Novità

Il supporto per testo formattato nel documento di record è un miglioramento recente. In precedenza, il contenuto in formato Rich Text veniva visualizzato come testo normale nei documenti generati. Questa nuova funzionalità consente il corretto rendering del contenuto formattato negli output PDF.

Riferimento per il supporto dei tag di HTML

Tag completamente supportati

Questi tag sono completamente supportati con la corretta creazione dei nodi di accessibilità:

Tag HTML
Descrizione
Supporto del documento record
Accessibilità
Esempio
<p>
Paragrafo
Completamente supportato - Correzione nodo <P>
<p>This is a paragraph.</p>
<br/>
Interruzione di riga
Completamente supportato - entro <P> nodo
<p>Line 1<br/>Line 2</p>
<b>
Testo grassetto
Completamente supportato - entro <P> nodo
<b>bold text</b>
<i>
Testo corsivo
Completamente supportato - entro <P> nodo
<i>italic text</i>
<span>
Contenitore in linea generico
all’interno di elementi di blocco
<span>styled text</span>
<sub>
Pedice
Completamente supportato - all’interno di elementi di blocco
H<sub>2</sub>O
<sup>
Apice
Completamente supportato - All’interno di elementi blocco
E=mc<sup>2</sup>
<a>
Collegamento ipertestuale
Supporto limitato: è necessaria una nidificazione corretta
<a href="url">link text</a>

Elencare problemi di accessibilità

Il rendering elenco corrente crea <P> nodi invece della struttura elenco corretta:

Current: <P>1. First item
Current: <P>2. Second item

Expected: <L>
Expected:   <LI>
Expected:     <LBL>1.
Expected:     <LBody>First item

Tag non supportati

Questi tag non sono supportati e non verranno visualizzati correttamente:

Tag HTML
Descrizione
Soluzione alternativa
<h1> - <h6>
Tag di intestazione
Utilizza tag con stile <p> o intestazioni a livello di progettazione
<img>
Immagini
Utilizzare campi immagine o modelli struttura separati
<code>
Blocchi di codice
Usa caratteri monospazio con <span> stile
<blockquote>
Blocca offerte
Usa tag <p> con rientro
<table>
Tabelle
Utilizzare i componenti della tabella del modulo adattivo

Esempi di codice

Formattazione testo di base

<!--  Supported - renders correctly -->
<p>This paragraph contains <b>bold text</b> and <i>italic text</i>.</p>

<!--  Supported - combined formatting -->
<p>This text is <i><b>bold and italic</b></i>.</p>

<!--  Unsupported - headings don't work -->
<h1>This won't render as a heading</h1>

Elenchi

<!-- ⚠️ Partially supported - renders but not accessible -->
<ol>
  <li>First numbered item</li>
  <li>Second numbered item</li>
</ol>

<ul>
  <li>First bullet point</li>
  <li>Second bullet point</li>
</ul>

Collegamenti

<!--  Supported - but must be within block elements -->
<p>Visit our <a href="https://example.com">website</a> for more information.</p>

<!--  Incorrect - link not properly nested -->
<a href="https://example.com">Standalone link</a>

Notazione scientifica

<!--  Supported - but limited accessibility -->
<p>Water formula: H<sub>2</sub>O</p>
<p>Einstein's equation: E=mc<sup>2</sup></p>

Informazioni correlate

Documentazione di AEM Forms

Riferimenti tecnici

Guide alle best practice

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab