Manual:HtmlArmor.php/cs
Verze MediaWiki: | ≥ 1.28 Gerrit change 284750 |
Soubor MediaWiki: HtmlArmor.php | |
---|---|
Lokalita: | includes/libs/ |
Zdrojový kód: | master • 1.43.1 • 1.42.6 • 1.39.12 |
Třídy: | 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 <b>escaped!</b></stuff>
fooBar( new HtmlArmor( "this will <i>not</i> be <b>escaped!</b>" ) );
// <stuff>this will <i>not</i> be <b>escaped!</b></stuff>"