HTML varlık kodlayıcı / çözücü

HTML varlığı, HTML kaynak kodunda bir karakteri temsil eden kısa bir metin dizisidir. Varlıklar, bir karakterin ham HTML'de belirsiz veya geçersiz olacağı durumlarda kullanılır – örneğin `<` ve `>` HTML etiketlerini sınırladığından, içerikteki gerçek bir `<` karakteri `&lt;` olarak yazılmalıdır; aksi hâlde tarayıcı bunu bir etiketin başlangıcı olarak yorumlar.

HTML varlıkları iki biçimde bulunur. Adlandırılmış varlıklar `&` işaretinden sonra ve `;`'dan önce okunabilir bir ad kullanır; örneğin `&amp;` ve işareti için, `&copy;` telif hakkı sembolü için, `&mdash;` em tire için. Sayısal varlıklar ondalık veya onaltılık bir Unicode kod noktası kullanır – `&#169;` ve `&#xA9;` ikisi de © telif hakkı sembolünü verir.

Her geliştiricinin bilmesi gereken beş ayrılmış HTML karakteri:

• `&amp;` – ve işareti `&`
• `&lt;` – küçüktür işareti `<`
• `&gt;` – büyüktür işareti `>`
• `&quot;` – çift tırnak `"`
• `&#39;` – tek tırnak / kesme işareti `'`

Bu beşin ötesinde HTML, yüzlerce başka karakter için adlandırılmış varlıklar tanımlar: aksanlı harfler (`&eacute;` = akut aksentli e), bölünemez boşluklar (`&nbsp;`), tipografik noktalama (`&mdash;` = em tire, `&ldquo;` ve `&rdquo;` = tipografik tırnak), para birimi sembolleri (`&euro;` = euro işareti), matematiksel semboller ve Yunan harfleri.

Bir HTML belgesine düz metin eklerken ve bu metin HTML'nin ayırdığı karakterler içerebiliyorsa her zaman HTML varlıklarını kodlayın. En yaygın durumlar:

• Kullanıcı tarafından oluşturulan içeriği veya blog metnini ham HTML depolayan bir CMS veya şablona yapıştırmak.
• Blog yazılarına veya belgeleme sayfalarına kod örnekleri gömmek – `<strong>kalın</strong>` gibi bir parça, tarayıcının görünür metin olarak oluşturması için `&lt;strong&gt;kalın&lt;/strong&gt;` olarak kodlanmalıdır.
• `<`, `>` ve `&`'nin çevresindeki HTML yapısını bozabileceği HTML `<script>` etiketlerine gömülü JSON yükleri oluşturmak.
• Çift tırnak içerebilecek öznitelik değerleri saklamak ve çevresindeki `"..."` sınırlandırıcıların bozulmasını önlemek.
• HTML e-posta şablonları için özel karakterleri kodlamak.

Yalnızca beş ayrılmış karakteri kaçışlamanız gerektiğinde temel modu kullanın. Maksimum HTML uyumluluğu için veya yalnızca ASCII'yi destekleyen eski sistemlerde genişletilmiş modu kullanın.

Zaten kaçışlanmış metin aldığınızda ve özgün karakterleri okumak, işlemek veya görüntülemek istediğinizde HTML varlıklarını çözün. Arama terimlerinde bu genellikle HTML decode, HTML unescape veya HTML kodlanmış metni normal metne dönüştürme olarak adlandırılır. Yaygın durumlar:

• `Tom & Jerry` beklerken `Tom &amp; Jerry` döndüren API yanıtları – bu durumda HTML varlıklarını metne dönüştürmeniz gerekir.
• Bir CMS'nin ikiye katlanmış kodlaması nedeniyle `&lt;` veya `<` yerine `&amp;lt;` gibi dizeler içeren içerikler.
• Metin içeriği genellikle HTML kodlanmış olan RSS veya Atom akış girdilerini okumak.
• HTML kaçışlı sorgu parametreleri veya hata mesajları içeren günlük satırlarını incelemek.
• İçeriğin varlık olarak saklandığı HTML kaynak dosyasından görünür metni kopyalamak.

Bu araç hem adlandırılmış varlıkları (`&amp;`, `&copy;`, `&mdash;`, `&nbsp;` ve yüzlerce daha) hem de ondalık (`&#169;`) ve onaltılık (`&#xA9;`) gösterimlerdeki sayısal varlıkları çözer.

Bu kodlayıcı iki kodlama ayrıntı düzeyi sunar.

Temel mod yalnızca beş ayrılmış HTML karakterini kodlar: `&` `&amp;`'ye, `<` `&lt;`'ye, `>` `&gt;`'ye, `"` `&quot;`'ye, `'` `&#39;`'ya dönüşür. `é` ve `ü` gibi aksanlı harfler, `©` ve `—` gibi semboller, 😀 gibi emojiler dahil diğer tüm karakterler değiştirilmeden aktarılır. Hedef ortamınız Unicode'u yerel olarak desteklediğinde temel modu kullanın.

Genişletilmiş mod aynı beş ayrılmış karakteri kodlar ve ek olarak her ASCII dışı karakteri ondalık sayısal varlığa dönüştürür. Örneğin `é` `&#233;`'e, `©` `&#169;`'a, `—` `&#8212;`'ye, 😀 ise `&#128512;`'ye dönüşür. Salt ASCII çıktısına ihtiyaç duyduğunuzda veya eski sistemler için genişletilmiş modu kullanın.

Geliştiriciler aynı görevi zaman zaman htmlDecode, htmlEncode, HTML escape, HTML unescape, HTML kodla veya HTML çöz gibi terimlerle arar. İfade farklılık gösterse de amaç aynıdır: okunabilir karakterler ile HTML varlık gösterimleri arasında güvenli dönüşüm.

Temel modda ileri-geri dönüşüm örneği:

• Giriş: `Café & © 😀`
• Kodlandı (temel): `Café &amp; © 😀`
• Çözüldü: `Café & © 😀`

Genişletilmiş modda ileri-geri dönüşüm örneği:

• Giriş: `Café & © 😀`
• Kodlandı (genişletilmiş): `Caf&#233; &amp; &#169; &#128512;`
• Çözüldü: `Café & © 😀`

HTML varlık kodlaması ve URL kodlaması, farklı amaçlara ve farklı çıktılara sahip iki tamamen farklı mekanizmadır – her ikisi de özel karakterleri alternatif bir gösterime dönüştürse de.

HTML varlık kodlaması HTML belgeleri içindir. HTML işaretlemesinde özel anlam taşıyan karakterleri, HTML ayrıştırıcısının metin içeriği olarak ele aldığı varlık dizileriyle değiştirir. Sonuç okunabilir metin olmaya devam eder – `&amp;` tarayıcıda `&` olarak görüntülenir.

URL kodlaması (yüzde kodlama) URL'ler içindir. URL'de güvenli olmayan veya ayrılmış karakterleri yüzde kodlamalı bayt dizileriyle değiştirir. Boşluk `%20`'ye, ve işareti `%26`'ya, küçüktür işareti `%3C`'ye dönüşür.

Aynı karakterlerin her iki sistemdeki karşılaştırması:

• `&` – HTML: `&amp;`, URL: `%26`
• `<` – HTML: `&lt;`, URL: `%3C`
• `>` – HTML: `&gt;`, URL: `%3E`
• `"` – HTML: `&quot;`, URL: `%22`
• `'` – HTML: `&#39;`, URL: `%27`

HTML kodlanmış metni URL kodlayıcısına yapıştırırsanız, varlık karakterlerinin kendisini (`&`, `;`, `#`) kodlar – bu neredeyse hiçbir zaman istenen sonuç değildir. HTML varlık çözme, HTML varlık kodlama ve HTML kodlanmış metni okunabilir metne dönüştürmek için bu sayfayı kullanın.

HTML varlık kodlaması (bu araç) karakterleri HTML varlık eşdeğerlerine dönüştürür ve bu işlemi tersine çevirir. Hiçbir HTML öğesi eklemez, silmez veya yeniden yapılandırmaz. Belge yapısı korunur; yalnızca özel karakterlerin gösterimi değişir.

HTML temizleme, HTML işaretlemesini kaldıran veya yeniden yazan farklı bir işlemdir: istenmeyen etiketleri siler, öznitelikleri normalleştirir veya potansiyel olarak tehlikeli içeriği arındırır. Bir temizleme işlevi `<b onclick="...">kalın</b>` öğesini `<b>kalın</b>` veya yalnızca `kalın` olarak dönüştürebilir.

Bu araç HTML'yi temizlemez. Kodlayıcıya ham HTML yapıştırırsanız, işaretlemedeki açı ayraçlarını ve diğer ayrılmış karakterleri kodlayarak `<p>Merhaba</p>` öğesini `&lt;p&gt;Merhaba&lt;/p&gt;`'ya dönüştürür. Hiçbir öğeyi incelemez, silmez veya yeniden yapılandırmaz.

Bu araç aynı zamanda bir metin temizleyici de değildir. Fazla boşlukları kaldırmaz, aksanları silmez ve satır sonlarını normalleştirmez. Tek görevi HTML varlıklarını kodlamak ve çözmektir.