Come codificare e decodificare entità HTML

Inserisci il testo e imposta encode per l’escaping HTML; con testo non vuoto, un valore diverso attiva l’unescaping. Se il testo è vuoto, la risposta ha esito positivo, mantiene vuoto il testo trasformato e conserva la modalità fornita.

Capire il ruolo dei due campi

HTML Entities permette di lavorare con testo che contiene caratteri da rappresentare attraverso entità HTML oppure con entità da riportare a una forma testuale. È utile quando vuoi osservare la differenza tra escaping e unescaping senza modificare manualmente la stringa. Il campo del testo è facoltativo e, se non fornisci un valore, viene trattato come vuoto. Anche la modalità è facoltativa: in sua assenza viene usato encode.

La scelta della modalità va fatta in base all’operazione che vuoi applicare. Per un testo non vuoto, il valore encode segue l’operazione di escaping HTML, mentre un valore diverso segue l’operazione di unescaping HTML. Questa distinzione è importante perché il comportamento non dipende dal fatto che la modalità abbia il nome decode: conta il confronto con il valore encode.

Usare testo e modalità passo dopo passo

1. Prepara il testo da elaborare e inseriscilo nel campo dedicato. Per provare l’unescaping, usa una stringa che contenga entità HTML; per provare l’escaping, scegli invece un testo non vuoto con caratteri che vuoi sottoporre all’operazione HTML.
2. Scegli la modalità. Imposta encode quando vuoi applicare l’escaping HTML. Se il testo non è vuoto, ogni altro valore inserito nel campo della modalità porta al percorso di unescaping HTML.
3. Controlla che il valore sia scritto come desideri prima di avviare l’elaborazione. Una modalità diversa da encode non viene descritta come un errore: per un testo non vuoto determina l’altro percorso di trasformazione.
4. Avvia l’elaborazione e leggi il testo trasformato nella risposta. Per un’operazione riuscita, verifica anche la modalità restituita, così puoi confrontare il risultato con l’impostazione scelta.
5. Se lasci vuoto il testo, puoi comunque inviare la richiesta. In questo caso l’elaborazione termina con esito positivo, il testo trasformato è vuoto e la modalità fornita viene mantenuta, senza applicare una delle due operazioni previste per il testo non vuoto.
6. Ripeti la prova con l’altra modalità soltanto dopo aver identificato il percorso desiderato. Per esempio, una stringa con entità HTML richiede attenzione al risultato che vuoi ottenere, perché l’unescaping mira a riportare quelle entità verso una forma testuale.

Questa procedura separa la preparazione dell’input dalla lettura della risposta. Se ometti entrambi i valori, il testo rimane vuoto e la modalità predefinita è encode; il caso non va confuso con una trasformazione applicata a contenuto effettivo.

Interpretare trasformazione e risposta

La risposta va letta insieme ai valori inviati. Quando il testo non è vuoto e la modalità è encode, il testo trasformato rappresenta l’esito dell’escaping HTML. Quando la modalità contiene un valore differente, lo stesso tipo di input segue l’unescaping HTML; perciò un risultato inatteso può dipendere dalla modalità, non necessariamente dal testo inserito.

Il campo della modalità conserva un ruolo informativo anche nel caso vuoto. Se non c’è testo da trasformare, la risposta positiva con testo trasformato vuoto indica che è stato gestito il caso di input vuoto, non che sia stata eseguita un’operazione su una stringa. La modalità fornita resta disponibile nella risposta, secondo il comportamento verificato per questo scenario.

Usa il testo restituito per controllare l’effetto dell’operazione scelta, ma non trattare questa descrizione come una garanzia sulla copertura di tutte le entità HTML o su un risultato di ritorno identico in ogni situazione. La capacità verificata riguarda l’elaborazione di testo e modalità, con risposte riuscite osservate per encoding, decoding e input vuoto.

Esempio pratico

Devi preparare una breve stringa che contiene il carattere < prima di usarla in un contesto HTML.

Inserisci 5 < 7 nel campo del testo, imposta encode e avvia l’elaborazione. Controlla che la risposta positiva includa il testo trasformato insieme alla modalità usata, senza basarti soltanto sull’aspetto visivo della stringa.

La risposta mostra un esito positivo, un testo trasformato e la modalità encode; il contenuto trasformato può differire dal testo inserito.

Limiti

• La capacità verificata riguarda testo, modalità e gestione dell’input vuoto; non garantisce la copertura di tutte le entità HTML. Il contratto dichiara inoltre che lo strumento non usa accesso alla rete, senza fornire da questo dato conclusioni su archiviazione o riservatezza.

Errori comuni

• Confondere il nome della modalità con il suo comportamento. Per un testo non vuoto soltanto encode attiva l’escaping HTML; ogni altro valore porta all’unescaping. Prima dell’avvio, confronta il valore inserito con encode e correggilo se non corrisponde al percorso che vuoi usare.

Domande frequenti

Quale modalità viene usata se non ne scelgo una?

Se non inserisci una modalità, viene usato encode. Quando il testo contiene caratteri, questo valore applica l’operazione di escaping HTML; il comportamento predefinito non va quindi interpretato come un percorso di unescaping.

Che cosa restituisce un input senza testo?

Quando il testo è vuoto, l’elaborazione termina con esito positivo senza applicare l’operazione prevista per un testo non vuoto. La risposta contiene un testo trasformato vuoto e mantiene la modalità che hai fornito.

Una modalità diversa da encode causa un rifiuto?

Per un testo non vuoto, un valore diverso da encode segue il percorso di unescaping HTML. Non è quindi corretto descrivere ogni altra modalità come automaticamente rifiutata, anche se va verificato che quel comportamento sia quello desiderato.