Příručka:HtmlArmor.php

Verze MediaWiki:

≥ 1.28 Gerrit change 284750

Soubor MediaWiki: includes/libs/HtmlArmor/HtmlArmor.php
Zdrojový kód:	master • 1.45.3 • 1.44.5 • 1.43.8
Třídy:	Wikimedia\HtmlArmor\HtmlArmor

HtmlArmor je malá užitková třída pro situace, kdy chcete přijmout parametr textu, který je normálně escapován, ale v některých případech potřebuje přijmout nezpracovaný HTML kód.

Použití

/**
 * @param string|HtmlArmor $text
 * @return string
 */
function fooBar( $text ) {
	$html = HtmlArmor::getHtml( $text );
	return "<stuff>$html</stuff>";
}

Ve výše uvedeném příkladu může být parametr $text buď řetězec, který má být escapován, nebo objekt HtmlArmor, který by měl zůstat stejný. Funkce HtmlArmor::getHtml() se postará o escapování za vás a poskytne vám obsah, o kterém víte, že je bezpečný HTML.

fooBar( "this will be <b>escaped!</b>" );
// <stuff>this will be &lt;b&gt;escaped!&lt;/b&gt;</stuff>

fooBar( new HtmlArmor( "this will <i>not</i> be <b>escaped!</b>" ) );
// <stuff>this will <i>not</i> be <b>escaped!</b></stuff>"