Phalcon html

Html\Attributes¶

Class Source on GitHub

This class helps to work with HTML Attributes

Uses Phalcon\Html\Attributes\RenderInterface · Phalcon\Html\Escaper\AttributeEscaper · Phalcon\Html\Exceptions\AttributeNotRenderable · Phalcon\Support\Collection

Method Summary¶

Methods¶

__toString()¶

public function __toString(): string;

Alias of the render method

render()¶

public function render(): string;

Render attributes as HTML attributes

renderAttributes()¶

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 Source on GitHub

Html Attributes Interface

Uses Phalcon\Html\Attributes

Method Summary¶

Methods¶

getAttributes()¶

public function getAttributes(): Attributes;

Get Attributes

setAttributes()¶

public function setAttributes( Attributes $attributes ): AttributesInterface;

Set Attributes

Html\Attributes\RenderInterface¶

Interface Source on GitHub

Rendering interface for HTML attributes

Method Summary¶

Methods¶

render()¶

public function render(): string;

Generate a string representation

Html\Breadcrumbs¶

Class Source on GitHub

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 <dt> tags, while the whole string is enclosed in <dl> tags.

@property array $elements @property string $separator @property string $template

Method Summary¶

Methods¶

add()¶

public function add(
    string $label,
    string $link = ""
): static;

Adds a new crumb.

// Adding a crumb with a link
$breadcrumbs->add("Home", "/");

// Adding a crumb without a link (normally the last one)
$breadcrumbs->add("Users");

Crumbs are stored keyed by their link, so adding two crumbs that share the same link - including two link-less crumbs, which share the empty string key - keeps only the last one.

clear()¶

public function clear(): void;

Clears the crumbs

$breadcrumbs->clear()

getSeparator()¶

public function getSeparator(): string;

Returns the separator

remove()¶

public function remove( string $link ): void;

Removes crumb by url.

$breadcrumbs->remove("/admin/user/create");

// remove a crumb without an url (last link)
$breadcrumbs->remove();

render()¶

public function render(): string;

Renders and outputs breadcrumbs based on previously set template.

echo $breadcrumbs->render();

setSeparator()¶

public function setSeparator( string $separator ): static;

Set the separator

toArray()¶

public function toArray(): array;

Returns the internal breadcrumbs array

Html\Escaper¶

Class Source on GitHub

Phalcon\Html\Escaper

Escapes different kinds of text securing them. By using this component you may prevent XSS attacks.

The class is a façade over five per-context escapers (HtmlEscaper, AttributeEscaper, CssEscaper, JsEscaper, UrlEscaper). Each can be retrieved via the matching getXxxEscaper() accessor and substituted via the matching setXxxEscaper() setter. The legacy setEncoding, setFlags, and setDoubleEncode continue to fan out to all sub-objects so existing code keeps working.

This component only works with UTF-8. The PREG extension needs to be compiled with UTF-8 support.

$escaper = new \Phalcon\Html\Escaper();

$escaped = $escaper->css("font-family: <Verdana>");

echo $escaped; // font\2D family\3A \20 \3C Verdana\3E

@property AttributeEscaper $attributeEscaper @property CssEscaper $cssEscaper @property HtmlEscaper $htmlEscaper @property JsEscaper $jsEscaper @property UrlEscaper $urlEscaper

Uses Phalcon\Html\Escaper\AttributeEscaper · Phalcon\Html\Escaper\CssEscaper · Phalcon\Html\Escaper\EscaperInterface · Phalcon\Html\Escaper\HtmlEscaper · Phalcon\Html\Escaper\JsEscaper · Phalcon\Html\Escaper\UrlEscaper

Method Summary¶

Properties¶

Methods¶

__construct()¶

public function __construct(
    string $encoding = "utf-8",
    int $flags,
    bool $doubleEncode = true
);

Constructor. Accepts the legacy scalar params for backward compatibility and fans them out to every sub-escaper so existing code keeps working.

attributes()¶

public function attributes( mixed $input = null ): string;

Escapes a HTML attribute string or array. Delegates to AttributeEscaper.

css()¶

public function css( string $input ): string;

Escape CSS strings. Delegates to CssEscaper.

detectEncoding()¶

final public function detectEncoding( string $input ): string|null;

Detects the character encoding of a string. Delegates to HtmlEscaper.

escapeCss()¶

public function escapeCss( string $input ): string;

escapeHtml()¶

public function escapeHtml( string|null $input = null ): string;

escapeHtmlAttr()¶

public function escapeHtmlAttr( string|null $input = null ): string;

escapeJs()¶

public function escapeJs( string $input ): string;

escapeUrl()¶

public function escapeUrl( string $input ): string;

getAttributeEscaper()¶

public function getAttributeEscaper(): AttributeEscaper;

getCssEscaper()¶

public function getCssEscaper(): CssEscaper;

getEncoding()¶

public function getEncoding(): string;

Returns the encoding from the HtmlEscaper.

getFlags()¶

public function getFlags(): int;

Returns the flags from the HtmlEscaper.

getHtmlEscaper()¶

public function getHtmlEscaper(): HtmlEscaper;

getJsEscaper()¶

public function getJsEscaper(): JsEscaper;

getUrlEscaper()¶

public function getUrlEscaper(): UrlEscaper;

html()¶

public function html( string|null $input = null ): string;

Escapes a HTML string. Delegates to HtmlEscaper.

js()¶

public function js( string $input ): string;

Escape javascript strings. Delegates to JsEscaper.

normalizeEncoding()¶

final public function normalizeEncoding( string $input ): string;

Normalizes a string's encoding to UTF-32. Delegates to HtmlEscaper.

setAttributeEscaper()¶

public function setAttributeEscaper( AttributeEscaper $escaper ): static;

setCssEscaper()¶

public function setCssEscaper( CssEscaper $escaper ): static;

setDoubleEncode()¶

public function setDoubleEncode( bool $doubleEncode ): static;

Sets the double_encode flag. Fans out to all sub-escapers.

$escaper->setDoubleEncode(false);

setEncoding()¶

public function setEncoding( string $encoding ): static;

Sets the encoding. Fans out to all sub-escapers.

$escaper->setEncoding("utf-8");

setFlags()¶

public function setFlags( int $flags ): static;

Sets the htmlspecialchars flags. Fans out to all sub-escapers.

$escaper->setFlags(ENT_XHTML);

setHtmlEscaper()¶

public function setHtmlEscaper( HtmlEscaper $escaper ): static;

setHtmlQuoteType()¶

public function setHtmlQuoteType( int $flags ): static;

Sets the HTML quoting type for htmlspecialchars.

$escaper->setHtmlQuoteType(ENT_XHTML);

setJsEscaper()¶

public function setJsEscaper( JsEscaper $escaper ): static;

setUrlEscaper()¶

public function setUrlEscaper( UrlEscaper $escaper ): static;

url()¶

public function url( string $input ): string;

Escapes a URL. Delegates to UrlEscaper.

Html\EscaperFactory¶

Class Source on GitHub

Class EscaperFactory

Method Summary¶

Methods¶

newInstance()¶

public function newInstance(): Escaper;

Create a new instance of the object

Html\Escaper\AbstractEscaper¶

Abstract Source on GitHub

Shared base for the per-context escaper objects. Holds the encoding, htmlspecialchars flag, and double-encode toggle, plus the encoding detection / normalization utilities used by the CSS and JS escapers.

Each concrete context (HtmlEscaper, AttributeEscaper, CssEscaper, JsEscaper, UrlEscaper) extends this so that callers can configure one context without affecting the others.

@property bool $doubleEncode @property string $encoding @property int $flags

Uses Phalcon\Html\Escaper\Traits\EscaperTrait

Method Summary¶

Methods¶

escapeMulti()¶

protected function escapeMulti(
    string $input,
    string $escapeChar,
    string $escapeExtra,
    bool $whitelist
): string;

Perform escaping of non-alphanumeric characters to different formats.

Html\Escaper\AttributeEscaper¶

Class Source on GitHub

Escapes either a single attribute value (string) or an associative array of attribute pairs. Boolean true becomes a bare key (e.g. disabled); false and null skip the entry; arrays are joined with a space.

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( mixed $input = null ): string;

escape()¶

public function escape( mixed $input = null ): string;

escapeValue()¶

protected function escapeValue( string $input ): string;

Encodes a single key/value via htmlspecialchars.

Html\Escaper\CssEscaper¶

Class Source on GitHub

Escapes a string for use inside a CSS value by replacing non-alphanumeric characters with their hexadecimal escape sequence.

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( string $input ): string;

escape()¶

public function escape( string $input ): string;

Html\Escaper\EscaperInterface¶

Interface Source on GitHub

Interface for Phalcon\Html\Escaper.

This declares the stable context-escaping surface. The concrete {@see \Phalcon\Html\Escaper} facade also exposes members that are not part of this contract - setDoubleEncode(), getFlags(), and the per-context sub-escaper getters/setters (getHtmlEscaper(), setAttributeEscaper(), and the rest). Type against the concrete class to reach those.

Method Summary¶

Methods¶

attributes()¶

public function attributes( string $input ): string;

Escapes a HTML attribute string.

The concrete {@see \Phalcon\Html\Escaper} also accepts an array of attribute pairs and tolerates null: an array is rendered as escaped key="value" pairs, null and false values are skipped, and true renders as a bare key. Callers typed against this interface pass a string. The widened signature lands in the next major.

css()¶

public function css( string $input ): string;

Escape CSS strings by replacing non-alphanumeric chars by their hexadecimal representation

getEncoding()¶

public function getEncoding(): string;

Returns the internal encoding used by the escaper

html()¶

public function html( string $input ): string;

Escapes a HTML string.

The concrete {@see \Phalcon\Html\Escaper} tolerates null, returning an empty string for it. The nullable signature lands in the next major.

js()¶

public function js( string $input ): string;

Escape Javascript strings by replacing non-alphanumeric chars by their hexadecimal representation

setEncoding()¶

public function setEncoding( string $encoding ): EscaperInterface;

Sets the encoding to be used by the escaper

setFlags()¶

public function setFlags( int $flags ): EscaperInterface;

Sets the HTML quoting type for htmlspecialchars

url()¶

public function url( string $input ): string;

Escapes a URL. Internally uses rawurlencode

Html\Escaper\Exception¶

Class Source on GitHub

Class Exception

Html\Escaper\HtmlEscaper¶

Class Source on GitHub

Escapes a string for use as HTML body content via htmlspecialchars.

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( string|null $input = null ): string;

escape()¶

public function escape( string|null $input = null ): string;

Html\Escaper\JsEscaper¶

Class Source on GitHub

Escapes a string for use inside a JavaScript context by replacing non-alphanumeric characters with their hexadecimal escape sequence.

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( string $input ): string;

escape()¶

public function escape( string $input ): string;

Html\Escaper\Traits\EscaperTrait¶

Trait Source on GitHub

Shared encoding/flags state and the encoding detection/normalization utilities used by the per-context escaper objects (HtmlEscaper, AttributeEscaper, CssEscaper, JsEscaper, UrlEscaper).

@property bool $doubleEncode @property string $encoding @property int $flags

Used by Phalcon\Html\Escaper\AbstractEscaper

Method Summary¶

Properties¶

Methods¶

detectEncoding()¶

final public function detectEncoding( string $input ): string|null;

Detects the character encoding of a string. Special-handling for chr(172) and chr(128) to chr(159) which fail to be detected by mb_detect_encoding().

getDoubleEncode()¶

public function getDoubleEncode(): bool;

getEncoding()¶

public function getEncoding(): string;

getFlags()¶

public function getFlags(): int;

normalizeEncoding()¶

final public function normalizeEncoding( string $input ): string;

Normalizes a string's encoding to UTF-32, used by the CSS and JS escapers before invoking the escape routines.

setDoubleEncode()¶

public function setDoubleEncode( bool $doubleEncode ): static;

setEncoding()¶

public function setEncoding( string $encoding ): static;

setFlags()¶

public function setFlags( int $flags ): static;

Html\Escaper\UrlEscaper¶

Class Source on GitHub

Escapes a string for use as a URL component via rawurlencode.

Uses Phalcon\Traits\Php\UrlTrait

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( string $input ): string;

escape()¶

public function escape( string $input ): string;

Html\Exception¶

Class Source on GitHub

Class Exception

Html\Exceptions\AttributeNotRenderable¶

Class Source on GitHub

Uses Phalcon\Html\Exception

Method Summary¶

Methods¶

__construct()¶

public function __construct(
    string $key,
    string $type
);

Html\Exceptions\FriendlyTitleConversionFailed¶

Class Source on GitHub

Uses Phalcon\Html\Exception

Method Summary¶

Methods¶

__construct()¶

public function __construct( string $message );

Html\Exceptions\InvalidResultsetValue¶

Class Source on GitHub

Uses InvalidArgumentException

Method Summary¶

Methods¶

__construct()¶

public function __construct();

Html\Exceptions\ServiceNotRegistered¶

Class Source on GitHub

Uses Phalcon\Html\Exception

Method Summary¶

Methods¶

__construct()¶

public function __construct( string $name );

Html\Exceptions\UsingRequiresTwoValues¶

Class Source on GitHub

Uses InvalidArgumentException

Method Summary¶

Methods¶

__construct()¶

public function __construct();

Html\Helper\AbstractHelper¶

Abstract Source on GitHub

@property string $delimiter @property EscaperInterface $escaper @property string $indent @property int $indentLevel

Uses Phalcon\Html\Escaper\EscaperInterface

Method Summary¶

Properties¶

Methods¶

__construct()¶

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null
);

AbstractHelper constructor.

close()¶

protected function close(
    string $tag,
    bool $raw = false
): string;

Produces a closing tag

indent()¶

protected function indent(): string;

Replicates the indent x times as per indentLevel

injectAttribute()¶

protected function injectAttribute(
    string $key,
    string $value,
    array $attributes
): array;

Forces $key => $value to the front of the attributes array, removing any existing entry for that key. This guarantees the attribute is always present and appears first in the rendered output.

orderAttributes()¶

protected function orderAttributes(
    array $overrides,
    array $attributes
): array;

Keeps all the attributes sorted - same order all the time

renderArrayElements()¶

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

renderAttributes()¶

protected function renderAttributes( array $attributes ): string;

Renders all the attributes

renderElement()¶

protected function renderElement(
    string $tag,
    array $attributes = []
): string;

Renders an element

renderFullElement()¶

protected function renderFullElement(
    string $tag,
    string $text,
    array $attributes = [],
    bool $raw = false
): string;

Renders an element

renderTag()¶

protected function renderTag(
    string $tag,
    array $attributes = [],
    string $close = ""
): string;

Renders a tag

selfClose()¶

protected function selfClose(
    string $tag,
    array $attributes = []
): string;

Produces a self close tag i.e.

Html\Helper\AbstractList¶

Abstract Source on GitHub

Class AbstractList

Method Summary¶

Properties¶

Methods¶

__invoke()¶

public function __invoke(
    string $indent = "    ",
    string|null $delimiter = null,
    array $attributes = []
): static;

__toString()¶

public function __toString();

Generates and returns the HTML for the list.

getTag()¶

abstract protected function getTag();

Returns the tag name.

Html\Helper\AbstractSeries¶

Abstract Source on GitHub

@property array $attributes @property array $store

Method Summary¶

Properties¶

Methods¶

__invoke()¶

public function __invoke(
    string $indent = "    ",
    string|null $delimiter = null
): static;

__toString()¶

public function __toString();

Generates and returns the HTML for the list. Entries are sorted by their integer key first, so an asset registered with a lower position renders before one registered with a higher position regardless of registration order.

reset()¶

public function reset(): static;

Resets the internal store.

getTag()¶

abstract protected function getTag(): string;

Returns the tag name.

pushOrPlace()¶

protected function pushOrPlace(
    array $entry,
    int $pos = -1
): void;

Appends an entry to the store, optionally at a specific integer position. When $pos is negative the entry is pushed onto the next available auto-increment slot. When $pos is non-negative the entry is placed at that key, advancing past any already-occupied slots so existing entries are not overwritten. The store is ksort()ed in __toString, so positions act as a sort key, not a strict address.

Html\Helper\Anchor¶

Class Source on GitHub

Class Anchor

@property bool $forceRaw

Uses Phalcon\Html\Escaper\EscaperInterface

Method Summary¶

Properties¶

Methods¶

__construct()¶

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null,
    bool $forceRaw = false
);

__invoke()¶

public function __invoke(
    string $href,
    string $text,
    array $attributes = [],
    bool $raw = false
): string;

Produce a tag

Html\Helper\Base¶

Class Source on GitHub

Class Base

Method Summary¶

Methods¶

__invoke()¶

public function __invoke(
    string|null $href = null,
    array $attributes = []
): string;

Produce a <base/> tag.

Html\Helper\Body¶

Class Source on GitHub

Class Body

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( array $attributes = [] ): string;

Produce a <body> tag.

Html\Helper\Breadcrumbs¶

Class Source on GitHub

This component offers an easy way to create breadcrumbs for your application. The resulting HTML when calling render() will have each breadcrumb enclosed in <li> tags, while the whole string is enclosed in <nav> and <ol> tags.

Uses Phalcon\Html\Escaper\EscaperInterface · Phalcon\Mvc\Url\UrlInterface · Phalcon\Traits\Support\Helper\Str\InterpolateTrait

Method Summary¶

Properties¶

Methods¶

__construct()¶

public function __construct(
    EscaperInterface $escaper,
    UrlInterface|null $url = null
);

AbstractHelper constructor.

__invoke()¶

public function __invoke(
    string $indent = "    ",
    string|null $delimiter = null
): static;

Sets the indent and delimiter and returns the object back

add()¶

public function add(
    string $text,
    string $link = "",
    string $icon = "",
    array $attributes = []
): static;

Adds a new crumb.

// Adding a crumb with a link
$breadcrumbs->add("Home", "/");

// Adding a crumb with added attributes
$breadcrumbs->add("Home", "/", ["class" => "main"]);

// Adding a crumb without a link (normally the last one)
$breadcrumbs->add("Users");

clear()¶

public function clear(): void;

Clears the crumbs

$breadcrumbs->clear()

clearAttributes()¶

public function clearAttributes(): static;

Clear the attributes of the parent element

getAttributes()¶

public function getAttributes(): array;

Get the attributes of the parent element

getPrefix()¶

public function getPrefix(): string;

Returns the link prefix.

getSeparator()¶

public function getSeparator(): string;

Returns the separator

getTemplate()¶

public function getTemplate(): array;

Return the current template

remove()¶

public function remove( int $index ): void;

Removes crumb by url.

// Remove the second element
$breadcrumbs->remove(2);

render()¶

public function render(): string;

Renders and outputs breadcrumbs based on previously set template.

echo $breadcrumbs->render();

setAttributes()¶

public function setAttributes( array $attributes ): static;

Set the attributes for the parent element

setPrefix()¶

public function setPrefix( string $prefix ): static;

Set the link prefix prepended to every non-empty link during rendering. When a Url service was injected, calling this method replaces it.

setSeparator()¶

public function setSeparator( string $separator ): static;

Set the separator

setTemplate()¶

public function setTemplate(
    string $main,
    string $line,
    string $last
): static;

Set the HTML template

toArray()¶

public function toArray(): array;

Returns the internal breadcrumbs array

Html\Helper\Button¶

Class Source on GitHub

Class Button

@property bool $forceRaw

Uses Phalcon\Html\Escaper\EscaperInterface

Method Summary¶

Properties¶

Methods¶

__construct()¶

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null,
    bool $forceRaw = false
);

__invoke()¶

public function __invoke(
    string $text,
    array $attributes = [],
    bool $raw = false
): string;

Produce a <button> tag.

Html\Helper\Close¶

Class Source on GitHub

Class Close

Method Summary¶

Methods¶

__invoke()¶

public function __invoke(
    string $tag,
    bool $raw = false
): string;

Produce a </...> tag.

Html\Helper\Doctype¶

Class Source on GitHub

Creates Doctype tags

Method Summary¶

Constants¶

Methods¶

__invoke()¶

public function __invoke(
    int $type = self::HTML5,
    string $delimiter = PHP_EOL
): static;

Produce a tag

__toString()¶

public function __toString(): string;

getType()¶

public function getType(): int;

Html\Helper\Element¶

Class Source on GitHub

Class Element

@property bool $forceRaw

Uses Phalcon\Html\Escaper\EscaperInterface

Method Summary¶

Properties¶

Methods¶

__construct()¶

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null,
    bool $forceRaw = false
);

__invoke()¶

public function __invoke(
    string $tag,
    string $text,
    array $attributes = [],
    bool $raw = false
): string;

Produce a tag.

Html\Helper\Form¶

Class Source on GitHub

Class Form

Method Summary¶

Methods¶

__invoke()¶

public function __invoke( array $attributes = [] ): string;

Produce a

public function __construct( EscaperInterface $escaper );

public function __invoke(
    string $text,
    string $separator = "-",
    bool $lowercase = true,
    mixed $replace = null
): string;

public function __invoke(
    string $src,
    array $attributes = []
): string;

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null
);

public function __toString();

public function label( array $attributes = [] ): static;

public function strict( bool $flag = true ): static;

protected function processChecked(): void;

protected function processUnchecked(): string;

public function __invoke(
    string $name,
    array $options,
    mixed $checked = null,
    array $attributes = []
): static;

public function __toString(): string;

abstract protected function isChecked( string $value ): bool;

protected function renderItem(
    string $value,
    array|string $definition
): string;

public function __invoke(
    string $name,
    string|null $value = null,
    array $attributes = []
): static;

public function __toString();

public function setValue( string|null $value = null ): static;

protected function isChecked( string $value ): bool;

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null,
    string $type = "text"
);

public function setType( string $type ): AbstractInput;

protected function isChecked( string $value ): bool;

public function add(
    string $text,
    string|null $value = null,
    array $attributes = [],
    bool $raw = false
): static;

public function addPlaceholder(
    string $text,
    string|null $value = null,
    array $attributes = [],
    bool $raw = false
): static;

public function fromData( SelectData $data ): static;

public function optGroup(
    string|null $label = null,
    array $attributes = []
): static;

public function placeholder( string $text ): static;

public function selected( string $selected ): static;

public function strict( bool $flag = true ): static;

protected function getTag(): string;

protected function optGroupEnd(): string;

protected function optGroupStart(
    string $label,
    array $attributes
): string;

public function __construct(
    array $data = [],
    array $attributes = []
);

public function getAttributes(): array;

public function getOptions(): array;

public function __construct(
    ResultsetInterface $resultset,
    array $using,
    array $attributesMap = []
);

public function getAttributes(): array;

public function getOptions(): array;

protected function readField(
    mixed $option,
    string $field
): mixed;

protected function resolve(): void;

public function __toString();

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null,
    bool $forceRaw = false
);

public function __invoke(
    string $label,
    array $attributes = [],
    bool $raw = false
): string;

public function add(
    string $href,
    array $attributes = [],
    int $position = -1
): static;

protected function getAttributes(
    string $href,
    array $attributes
): array;

protected function getTag(): string;

public function add(
    array $attributes = [],
    int $pos = -1
): static;

public function addHttp(
    string $httpEquiv,
    string $content,
    int $pos = -1
): static;

public function addName(
    string $name,
    string $content,
    int $pos = -1
): static;

public function addProperty(
    string $name,
    string $content,
    int $pos = -1
): static;

protected function getTag(): string;

public function __construct(
    EscaperInterface $escaper,
    Doctype|null $doctype = null,
    bool $forceRaw = false
);

public function add(
    string $text,
    array $attributes = [],
    bool $raw = false
): static;

protected function getTag(): string;

public function __construct(
    EscaperInterface $escaper,
    ResponseInterface|null $response = null
);

public function __invoke(
    string $href,
    string $type = "style",
    array $attributes = []
): string;

public function add(
    string $href,
    array $attributes = [],
    int $position = -1
): static;

public function beginInternal(): void;

public function endInternal(
    array $attributes = [],
    int $position = -1
): static;

protected function getAttributes(
    string $src,
    array $attributes
): array;

protected function getTag(): string;