--- title: "Phalcon Html" version: "5.9" --- > Documentation Index > Fetch the complete documentation index at: https://docs.phalcon.io/llms.txt > Use this file to discover all available pages before exploring further. # Phalcon Html :::info[NOTE] All classes are prefixed with `Phalcon` ::: ## Html\Attributes [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Attributes.zep) - __Namespace__ - `Phalcon\Html` - __Uses__ - `Phalcon\Html\Attributes\RenderInterface` - `Phalcon\Support\Collection` - __Extends__ `Collection` - __Implements__ - `RenderInterface` This class helps to work with HTML Attributes ### Methods ```php public function __toString(): string; ``` Alias of the render method ```php public function render(): string; ``` Render attributes as HTML attributes ```php protected function renderAttributes( array $attributes ): string; ``` @todo remove this when we refactor forms. Maybe remove this class? Put it into traits ## Html\Attributes\AttributesInterface ![Interface](/assets/images/interface-blue.svg) [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Attributes/AttributesInterface.zep) - __Namespace__ - `Phalcon\Html\Attributes` - __Uses__ - `Phalcon\Html\Attributes` - __Extends__ - __Implements__ * Phalcon\Html\Attributes\AttributesInterface * * Interface Phalcon\Html\Attributes\AttributesInterface */ ### Methods ```php public function getAttributes(): Attributes; ``` Get Attributes ```php public function setAttributes( Attributes $attributes ): AttributesInterface; ``` Set Attributes ## Html\Attributes\RenderInterface ![Interface](/assets/images/interface-blue.svg) [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Attributes/RenderInterface.zep) - __Namespace__ - `Phalcon\Html\Attributes` - __Uses__ - __Extends__ - __Implements__ * Phalcon\Html\Attributes\RenderInterface * * Interface Phalcon\Html\Attributes\RenderInterface */ ### Methods ```php public function render(): string; ``` Generate a string represetation ## Html\Breadcrumbs [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Breadcrumbs.zep) - __Namespace__ - `Phalcon\Html` - __Uses__ - `Phalcon\Di\DiInterface` - __Extends__ - __Implements__ Phalcon\Html\Breadcrumbs This component offers an easy way to create breadcrumbs for your application. The resulting HTML when calling `render()` will have each breadcrumb enclosed in `
` tags, while the whole string is enclosed in `
` tags. @deprecated Will be removed in future version Use \{@see Phalcon\Html\Helper\Breadcrumbs\} instead. ### Properties ```php /** * Keeps all the breadcrumbs * * @var array */ private $elements; /** * Crumb separator * * @var string */ private $separator = / ; /** * The HTML template to use to render the breadcrumbs. * * @var string */ private $template =
%label%
; ``` ### Methods ```php public function add( string $label, string $link = string ): Breadcrumbs; ``` Adds a new crumb. ```php // Adding a crumb with a link $breadcrumbs->add("Home", "/"); // Adding a crumb without a link (normally the last one) $breadcrumbs->add("Users"); ``` ```php public function clear(): void; ``` Clears the crumbs ```php $breadcrumbs->clear() ``` ```php public function getSeparator(): string; ``` Crumb separator ```php public function remove( string $link ): void; ``` Removes crumb by url. ```php $breadcrumbs->remove("/admin/user/create"); // remove a crumb without an url (last link) $breadcrumbs->remove(); ``` ```php public function render(): string; ``` Renders and outputs breadcrumbs based on previously set template. ```php echo $breadcrumbs->render(); ``` ```php public function setSeparator( string $separator ): Breadcrumbs; ``` ```php public function toArray(): array; ``` Returns the internal breadcrumbs array ## Html\Escaper [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Escaper.zep) - __Namespace__ - `Phalcon\Html` - __Uses__ - `Phalcon\Html\Escaper\EscaperInterface` - __Extends__ - __Implements__ - `EscaperInterface` Phalcon\Html\Escaper Escapes different kinds of text securing them. By using this component you may prevent XSS attacks. This component only works with UTF-8. The PREG extension needs to be compiled with UTF-8 support. ```php $escaper = new \Phalcon\Html\Escaper(); $escaped = $escaper->escapeCss("font-family: "); echo $escaped; // font\2D family\3A \20 \3C Verdana\3E ``` ### Properties ```php /** * @var bool */ protected $doubleEncode = true; /** * @var string */ protected $encoding = utf-8; /** * ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 * * @var int */ protected $flags = 11; ``` ### Methods ```php public function attributes( mixed $input ): string; ``` Escapes a HTML attribute string or array If the input is an array, the keys are the attribute names and the values are attribute values. If a value is boolean (true/false) then the attribute will have no value: `['disabled' => true]` -> `'disabled`` The resulting string will have attribute pairs separated by a space. ```php public function css( string $input ): string; ``` Escape CSS strings by replacing non-alphanumeric chars by their hexadecimal escaped representation ```php final public function detectEncoding( string $input ): string | null; ``` Detect the character encoding of a string to be handled by an encoder. Special-handling for chr(172) and chr(128) to chr(159) which fail to be detected by mb_detect_encoding() ```php public function escapeCss( string $input ): string; ``` Escape CSS strings by replacing non-alphanumeric chars by their hexadecimal escaped representation ```php public function escapeHtml( string $input = null ): string; ``` Escapes a HTML string. Internally uses htmlspecialchars ```php public function escapeHtmlAttr( string $input = null ): string; ``` Escapes a HTML attribute string ```php public function escapeJs( string $input ): string; ``` Escape JavaScript strings by replacing non-alphanumeric chars by their hexadecimal escaped representation ```php public function escapeUrl( string $input ): string; ``` Escapes a URL. Internally uses rawurlencode ```php public function getEncoding(): string; ``` ```php public function getFlags(): int; ``` ```php public function html( string $input = null ): string; ``` Escapes a HTML string. Internally uses htmlspecialchars ```php public function js( string $input ): string; ``` Escape javascript strings by replacing non-alphanumeric chars by their hexadecimal escaped representation ```php final public function normalizeEncoding( string $input ): string; ``` Utility to normalize a string's encoding to UTF-32. ```php public function setDoubleEncode( bool $doubleEncode ): Escaper; ``` Sets the double_encode to be used by the escaper ```php $escaper->setDoubleEncode(false); ``` ```php public function setEncoding( string $encoding ): EscaperInterface; ``` Sets the encoding to be used by the escaper ```php $escaper->setEncoding("utf-8"); ``` ```php public function setFlags( int $flags ): EscaperInterface; ``` Sets the HTML quoting type for htmlspecialchars ```php $escaper->setFlags(ENT_XHTML); ``` ```php public function setHtmlQuoteType( int $flags ): EscaperInterface; ``` Sets the HTML quoting type for htmlspecialchars ```php $escaper->setHtmlQuoteType(ENT_XHTML); ``` ```php public function url( string $input ): string; ``` Escapes a URL. Internally uses rawurlencode ```php protected function phpHtmlSpecialChars( string $input ): string; ``` Proxy method for testing ## Html\Escaper\EscaperInterface ![Interface](/assets/images/interface-blue.svg) [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Escaper/EscaperInterface.zep) - __Namespace__ - `Phalcon\Html\Escaper` - __Uses__ - __Extends__ - __Implements__ Interface for Phalcon\Html\Escaper ### Methods ```php public function attributes( string $input ): string; ``` Escapes a HTML attribute string ```php public function css( string $input ): string; ``` Escape CSS strings by replacing non-alphanumeric chars by their hexadecimal representation ```php public function getEncoding(): string; ``` Returns the internal encoding used by the escaper ```php public function html( string $input ): string; ``` Escapes a HTML string ```php public function js( string $input ): string; ``` Escape Javascript strings by replacing non-alphanumeric chars by their hexadecimal representation ```php public function setEncoding( string $encoding ): EscaperInterface; ``` Sets the encoding to be used by the escaper ```php public function setFlags( int $flags ): EscaperInterface; ``` Sets the HTML quoting type for htmlspecialchars ```php public function url( string $input ): string; ``` Escapes a URL. Internally uses rawurlencode ## Html\Escaper\Exception [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Escaper/Exception.zep) - __Namespace__ - `Phalcon\Html\Escaper` - __Uses__ - __Extends__ `\Exception` - __Implements__ Exceptions thrown in Phalcon\Html\Escaper will use this class ## Html\EscaperFactory [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/EscaperFactory.zep) - __Namespace__ - `Phalcon\Html` - __Uses__ - __Extends__ - __Implements__ Class EscaperFactory ### Methods ```php public function newInstance(): Escaper; ``` Create a new instance of the object ## Html\Exception [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Exception.zep) - __Namespace__ - `Phalcon\Html` - __Uses__ - __Extends__ `\Exception` - __Implements__ Phalcon\Html\Tag\Exception Exceptions thrown in Phalcon\Html\Tag will use this class ## Html\Helper\AbstractHelper ![Abstract](/assets/images/abstract-green.svg) [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/AbstractHelper.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - `Phalcon\Html\Escaper\EscaperInterface` - `Phalcon\Html\Exception` - __Extends__ - __Implements__ @property string $delimiter @property EscaperInterface $escaper @property string $indent @property int $indentLevel ### Properties ```php /** * @var string */ protected $delimiter = ; /** * @var EscaperInterface */ protected $escaper; /** * @var string */ protected $indent = ; /** * @var int */ protected $indentLevel = 1; ``` ### Methods ```php public function __construct( EscaperInterface $escaper ); ``` AbstractHelper constructor. ```php protected function close( string $tag, bool $raw = bool ): string; ``` Produces a closing tag ```php protected function indent(): string; ``` Replicates the indent x times as per indentLevel ```php protected function orderAttributes( array $overrides, array $attributes ): array; ``` Keeps all the attributes sorted - same order all the tome ```php protected function renderArrayElements( array $elements, string $delimiter ): string; ``` Traverses an array and calls the method defined in the first element with attributes as the second, returning the resulting string ```php protected function renderAttributes( array $attributes ): string; ``` Renders all the attributes ```php protected function renderElement( string $tag, array $attributes = [] ): string; ``` Renders an element ```php protected function renderFullElement( string $tag, string $text, array $attributes = [], bool $raw = bool ): string; ``` Renders an element ```php protected function renderTag( string $tag, array $attributes = [], string $close = string ): string; ``` Renders a tag ```php protected function selfClose( string $tag, array $attributes = [] ): string; ``` Produces a self close tag i.e. ## Html\Helper\AbstractList ![Abstract](/assets/images/abstract-green.svg) [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/AbstractList.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - `Phalcon\Html\Exception` - __Extends__ `AbstractHelper` - __Implements__ Class AbstractList ### Properties ```php /** * @var array */ protected $attributes; /** * @var string */ protected $elementTag = li; /** * @var array */ protected $store; ``` ### Methods ```php public function __invoke( string $indent = string, string $delimiter = null, array $attributes = [] ): AbstractList; ``` ```php public function __toString(); ``` Generates and returns the HTML for the list. ```php abstract protected function getTag(): string; ``` Returns the tag name. ## Html\Helper\AbstractSeries ![Abstract](/assets/images/abstract-green.svg) [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/AbstractSeries.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - __Extends__ `AbstractHelper` - __Implements__ @property array $attributes @property array $store ### Properties ```php /** * @var array */ protected $attributes; /** * @var array */ protected $store; ``` ### Methods ```php public function __invoke( string $indent = string, string $delimiter = null ): AbstractSeries; ``` ```php public function __toString(); ``` Generates and returns the HTML for the list. ```php public function reset(): AbstractSeries; ``` Resets the internal store. ```php abstract protected function getTag(): string; ``` Returns the tag name. ## Html\Helper\Anchor [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/Anchor.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - `Phalcon\Html\Exception` - __Extends__ `AbstractHelper` - __Implements__ Class Anchor ### Methods ```php public function __invoke( string $href, string $text, array $attributes = [], bool $raw = bool ): string; ``` Produce a <a> tag ```php protected function processAttributes( string $href, array $attributes ): array; ``` ## Html\Helper\Base [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/Base.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - `Phalcon\Html\Exception` - __Extends__ `AbstractHelper` - __Implements__ Class Base ### Methods ```php public function __invoke( string $href = null, array $attributes = [] ): string; ``` Produce a `` tag. ## Html\Helper\Body [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/Body.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - `Phalcon\Html\Exception` - __Extends__ `AbstractHelper` - __Implements__ Class Body ### Methods ```php public function __invoke( array $attributes = [] ): string; ``` Produce a `` tag. ## Html\Helper\Breadcrumbs [Source on GitHub](https://github.com/phalcon/cphalcon/blob/5.0.x/phalcon/Html/Helper/Breadcrumbs.zep) - __Namespace__ - `Phalcon\Html\Helper` - __Uses__ - `Phalcon\Html\Escaper\EscaperInterface` - `Phalcon\Support\Helper\Str\Interpolate` - __Extends__ `AbstractHelper` - __Implements__ This component offers an easy way to create breadcrumbs for your application. The resulting HTML when calling `render()` will have each breadcrumb enclosed in `
  • ` tags, while the whole string is enclosed in `