Convertitore di entità HTML

Il Convertitore di entità HTML è uno strumento gratuito che converte i riferimenti ai caratteri HTML nei caratteri decodificati e viceversa, per usarli in pagine web, sistemi di gestione dei contenuti e altri formati testuali.

Che cosa sono le entità HTML e a cosa servono?

Le entità HTML rappresentano i caratteri tramite un testo che HTML può distinguere dal proprio markup. Un riferimento a un carattere HTML inizia solitamente con una e commerciale e termina con un punto e virgola. Può essere un riferimento con nome, come & per la e commerciale, oppure numerico, come £ per il simbolo della sterlina.

Sono utili quando un carattere ha un significato speciale in HTML. Il simbolo letterale di minore potrebbe essere interpretato come l'inizio di un tag, quindi può essere scritto come <. I riferimenti ai caratteri consentono inoltre di rappresentare determinati caratteri in HTML o in markup compatibili senza confonderli con il markup o con la sintassi di controllo.

La codifica delle entità non è una forma di crittografia e non offre alcuna riservatezza. Chiunque può leggere o decodificare un riferimento a un'entità, quindi non usarlo mai per nascondere password, dati personali o contenuti riservati.

Come si usa il convertitore di entità HTML?

Inserisci il testo nel campo Encode o Decode, quindi leggi il risultato corrispondente in Codificato in entità HTML o Entità HTML decodificata. Usa l'output codificato quando il testo deve comparire in un contesto HTML appropriato, nel contenuto o in un attributo. Usa invece l'output decodificato quando ti servono i caratteri rappresentati dalle entità esistenti.

La conversione viene eseguita sul server. L'input viene trasmesso al server tramite HTTPS e non viene memorizzato.

Prima di procedere, verifica che ti servano davvero le entità HTML. Un valore contenuto in una stringa di query richiede in genere la codifica percentuale degli URL, mentre un dominio internazionalizzato usa Punycode. Il Decodificatore URL e il Convertitore IDN Punycode sono pensati per questi due formati.

Come si presenta un risultato codificato o decodificato?

Un risultato decodificato sostituisce i riferimenti alle entità riconosciuti con i caratteri corrispondenti. La forma codificata, invece, rappresenta i caratteri mediante la sintassi delle entità.

Input: <p>Tea & cake</p>

Output decodificato: <p>Tea & cake</p>

Le parentesi angolari nell'output decodificato sono caratteri che potrebbero diventare markup HTML se inseriti in una pagina come HTML. La decodifica non sanifica il contenuto, non rimuove gli script e non rende sicuro il codice HTML non attendibile. Tratta il materiale decodificato in base al contesto in cui verrà usato.

Esempi pratici e input problematici

Le entità con nome e i riferimenti numerici possono rappresentare lo stesso carattere in modi diversi. Per esempio, &amp; è il riferimento con nome per la e commerciale, mentre &#38; è il riferimento numerico decimale e &#x26; quello esadecimale.

• Gli spazi normali e i numeri letterali non sono riferimenti a entità e, in genere, rimangono testo normale.
• La punteggiatura cambia solo quando compare sotto forma di riferimento a un'entità riconosciuto o viene codificata intenzionalmente.
• Le lettere accentate, i sistemi di scrittura non latini e le emoji possono essere rappresentati mediante riferimenti numerici, che identificano i punti di codice Unicode indipendentemente dalla codifica del sorgente HTML. La corretta visualizzazione dipende dal supporto del font, mentre la codifica dei caratteri è importante se l'output decodificato viene archiviato o trasmesso.

Quando prepari le entità, includi il punto e virgola finale. I browser tollerano alcuni riferimenti privi di punto e virgola in contesti limitati, ma questa forma abbreviata può essere ambigua ed è meno compatibile tra parser diversi.

Dove si incontrano le entità HTML nell'uso quotidiano?

Le entità HTML compaiono spesso nel codice sorgente HTML, nei sistemi di gestione dei contenuti, negli editor di testo formattato e nelle email HTML. Per esempio, la vista codice di WordPress può contenere &nbsp; per uno spazio unificatore oppure &amp; quando una e commerciale deve essere mantenuta nel markup.

Possono inoltre comparire all'interno di dati trasportati in un altro formato. Si creano così più livelli di codifica, che devono essere gestiti nell'ordine corretto.

• Un payload JSON può contenere un frammento HTML il cui testo include entità. L'escape JSON e la decodifica delle entità HTML sono operazioni distinte.
• Una stringa di query può contenere HTML con codifica percentuale. Decodifica il livello URL prima di stabilire se il testo risultante contiene anche entità.
• Un URI di dati può contenere HTML o altro testo con entità, anche se l'URI stesso può usare la codifica percentuale o Base64.
• Un'email HTML può codificare la punteggiatura visibile e, allo stesso tempo, usare la codifica di trasferimento MIME per il trasporto.
• Un dominio internazionalizzato può comparire accanto a codice HTML con entità, ma il dominio viene normalmente rappresentato con Punycode anziché con entità HTML.

Perché la decodifica delle entità HTML non funziona o produce caratteri illeggibili?

La decodifica in genere non riesce perché l'input non è valido, usa uno schema di codifica diverso oppure contiene più livelli di codifica. Controlla nel testo originale la presenza di riferimenti a caratteri HTML con nome o numerici, invece di applicare ripetutamente le conversioni senza verificarne il risultato.

• Riferimento non valido: l'assenza della e commerciale, del cancelletto o del punto e virgola può impedirne il riconoscimento. Confronta il testo con forme come &amp; o &#38;.
• Input codificato due volte: un testo come &amp;lt; può essere decodificato una volta in &lt; e richiedere un secondo passaggio intenzionale per diventare un simbolo di minore.
• Codifica dei caratteri errata: un testo interpretato con la codifica sbagliata può mostrare simboli sostitutivi o caratteri accentati corrotti.
• Formato errato: un testo contenente simboli di percentuale potrebbe essere codificato come URL. Una lunga sequenza composta da lettere, cifre, simboli più, barre o segni di uguale finali potrebbe essere Base64.
• Se l'input è Base64, variante o alfabeto errati: Base64 sicuro per gli URL usa caratteri diversi rispetto al Base64 standard. Anche l'assenza del padding può impedire il funzionamento di alcuni decodificatori. Questi problemi non riguardano la sintassi delle entità HTML e richiedono un Decodificatore Base64.

Domande frequenti

Perché &nbsp; sembra uno spazio normale?

Rappresenta uno spazio unificatore, che di solito appare come uno spazio normale ma impedisce l'interruzione di riga in quel punto. Gli editor possono conservarlo senza renderlo visibile, quindi, quando analizzi problemi di spaziatura, usa la vista sorgente o esamina i singoli caratteri.

I nomi delle entità HTML distinguono tra maiuscole e minuscole?

Sì. I riferimenti ai caratteri con nome hanno grafie definite e l'uso di maiuscole o minuscole può determinare se un riferimento viene riconosciuto. Usa esattamente il nome pubblicato e includi il punto e virgola, senza affidarti alla correzione automatica degli errori da parte del browser.

Devo usare un'entità per ogni lettera accentata?

No. Un documento HTML UTF-8 dichiarato correttamente può contenere direttamente caratteri come é, £ e 中文. Le entità restano utili quando sono richieste dalla sintassi del markup, da un sistema meno recente o da una specifica regola di pubblicazione.

Posso usare le entità HTML in XML?

In XML è predefinito solo un piccolo insieme di entità con nome, tra cui &amp;, &lt;, &gt;, &quot; e &apos;. Molti nomi validi in HTML non sono validi in XML, a meno che non siano definiti da un tipo di documento. Per questo, i riferimenti numerici ai caratteri sono spesso la scelta più sicura.

Un convertitore di entità può correggere il codice HTML danneggiato?

No. Può convertire i riferimenti alle entità, ma non bilancia i tag, non corregge l'annidamento e non convalida il documento. Dopo la conversione, controlla il markup circostante e, se la pagina continua a comportarsi in modo imprevisto, usa un validatore HTML.

Controlli finali

Verifica se il contenuto di origine usa riferimenti a caratteri HTML con nome o numerici, converti soltanto il livello necessario e confronta il risultato con il testo che dovrebbe essere visibile. Prima di inserire il contenuto decodificato in una pagina pubblicata, controlla le eventuali parentesi angolari, virgolette e e commerciali risultanti nel loro effettivo contesto HTML.