✏️ Editing: Html.php Read Only

<?php

/**
 * This file is part of the Nette Framework (https://nette.org)
 * Copyright (c) 2004 David Grudl (https://davidgrudl.com)
 */
declare (strict_types=1);
namespace RectorPrefix202411\Nette\Utils;

use RectorPrefix202411\Nette;
use RectorPrefix202411\Nette\HtmlStringable;
use function is_array, is_float, is_object, is_string;
/**
 * HTML helper.
 *
 * @property string|null $accept
 * @property string|null $accesskey
 * @property string|null $action
 * @property string|null $align
 * @property string|null $allow
 * @property string|null $alt
 * @property bool|null   $async
 * @property string|null $autocapitalize
 * @property string|null $autocomplete
 * @property bool|null   $autofocus
 * @property bool|null   $autoplay
 * @property string|null $charset
 * @property bool|null   $checked
 * @property string|null $cite
 * @property string|null $class
 * @property int|null    $cols
 * @property int|null    $colspan
 * @property string|null $content
 * @property bool|null   $contenteditable
 * @property bool|null   $controls
 * @property string|null $coords
 * @property string|null $crossorigin
 * @property string|null $data
 * @property string|null $datetime
 * @property string|null $decoding
 * @property bool|null   $default
 * @property bool|null   $defer
 * @property string|null $dir
 * @property string|null $dirname
 * @property bool|null   $disabled
 * @property bool|null   $download
 * @property string|null $draggable
 * @property string|null $dropzone
 * @property string|null $enctype
 * @property string|null $for
 * @property string|null $form
 * @property string|null $formaction
 * @property string|null $formenctype
 * @property string|null $formmethod
 * @property bool|null   $formnovalidate
 * @property string|null $formtarget
 * @property string|null $headers
 * @property int|null    $height
 * @property bool|null   $hidden
 * @property float|null  $high
 * @property string|null $href
 * @property string|null $hreflang
 * @property string|null $id
 * @property string|null $integrity
 * @property string|null $inputmode
 * @property bool|null   $ismap
 * @property string|null $itemprop
 * @property string|null $kind
 * @property string|null $label
 * @property string|null $lang
 * @property string|null $list
 * @property bool|null   $loop
 * @property float|null  $low
 * @property float|null  $max
 * @property int|null    $maxlength
 * @property int|null    $minlength
 * @property string|null $media
 * @property string|null $method
 * @property float|null  $min
 * @property bool|null   $multiple
 * @property bool|null   $muted
 * @property string|null $name
 * @property bool|null   $novalidate
 * @property bool|null   $open
 * @property float|null  $optimum
 * @property string|null $pattern
 * @property string|null $ping
 * @property string|null $placeholder
 * @property string|null $poster
 * @property string|null $preload
 * @property string|null $radiogroup
 * @property bool|null   $readonly
 * @property string|null $rel
 * @property bool|null   $required
 * @property bool|null   $reversed
 * @property int|null    $rows
 * @property int|null    $rowspan
 * @property string|null $sandbox
 * @property string|null $scope
 * @property bool|null   $selected
 * @property string|null $shape
 * @property int|null    $size
 * @property string|null $sizes
 * @property string|null $slot
 * @property int|null    $span
 * @property string|null $spellcheck
 * @property string|null $src
 * @property string|null $srcdoc
 * @property string|null $srclang
 * @property string|null $srcset
 * @property int|null    $start
 * @property float|null  $step
 * @property string|null $style
 * @property int|null    $tabindex
 * @property string|null $target
 * @property string|null $title
 * @property string|null $translate
 * @property string|null $type
 * @property string|null $usemap
 * @property string|null $value
 * @property int|null    $width
 * @property string|null $wrap
 *
 * @method self accept(?string $val)
 * @method self accesskey(?string $val, bool $state = null)
 * @method self action(?string $val)
 * @method self align(?string $val)
 * @method self allow(?string $val, bool $state = null)
 * @method self alt(?string $val)
 * @method self async(?bool $val)
 * @method self autocapitalize(?string $val)
 * @method self autocomplete(?string $val)
 * @method self autofocus(?bool $val)
 * @method self autoplay(?bool $val)
 * @method self charset(?string $val)
 * @method self checked(?bool $val)
 * @method self cite(?string $val)
 * @method self class(?string $val, bool $state = null)
 * @method self cols(?int $val)
 * @method self colspan(?int $val)
 * @method self content(?string $val)
 * @method self contenteditable(?bool $val)
 * @method self controls(?bool $val)
 * @method self coords(?string $val)
 * @method self crossorigin(?string $val)
 * @method self datetime(?string $val)
 * @method self decoding(?string $val)
 * @method self default(?bool $val)
 * @method self defer(?bool $val)
 * @method self dir(?string $val)
 * @method self dirname(?string $val)
 * @method self disabled(?bool $val)
 * @method self download(?bool $val)
 * @method self draggable(?string $val)
 * @method self dropzone(?string $val)
 * @method self enctype(?string $val)
 * @method self for(?string $val)
 * @method self form(?string $val)
 * @method self formaction(?string $val)
 * @method self formenctype(?string $val)
 * @method self formmethod(?string $val)
 * @method self formnovalidate(?bool $val)
 * @method self formtarget(?string $val)
 * @method self headers(?string $val, bool $state = null)
 * @method self height(?int $val)
 * @method self hidden(?bool $val)
 * @method self high(?float $val)
 * @method self hreflang(?string $val)
 * @method self id(?string $val)
 * @method self integrity(?string $val)
 * @method self inputmode(?string $val)
 * @method self ismap(?bool $val)
 * @method self itemprop(?string $val)
 * @method self kind(?string $val)
 * @method self label(?string $val)
 * @method self lang(?string $val)
 * @method self list(?string $val)
 * @method self loop(?bool $val)
 * @method self low(?float $val)
 * @method self max(?float $val)
 * @method self maxlength(?int $val)
 * @method self minlength(?int $val)
 * @method self media(?string $val)
 * @method self method(?string $val)
 * @method self min(?float $val)
 * @method self multiple(?bool $val)
 * @method self muted(?bool $val)
 * @method self name(?string $val)
 * @method self novalidate(?bool $val)
 * @method self open(?bool $val)
 * @method self optimum(?float $val)
 * @method self pattern(?string $val)
 * @method self ping(?string $val, bool $state = null)
 * @method self placeholder(?string $val)
 * @method self poster(?string $val)
 * @method self preload(?string $val)
 * @method self radiogroup(?string $val)
 * @method self readonly(?bool $val)
 * @method self rel(?string $val)
 * @method self required(?bool $val)
 * @method self reversed(?bool $val)
 * @method self rows(?int $val)
 * @method self rowspan(?int $val)
 * @method self sandbox(?string $val, bool $state = null)
 * @method self scope(?string $val)
 * @method self selected(?bool $val)
 * @method self shape(?string $val)
 * @method self size(?int $val)
 * @method self sizes(?string $val)
 * @method self slot(?string $val)
 * @method self span(?int $val)
 * @method self spellcheck(?string $val)
 * @method self src(?string $val)
 * @method self srcdoc(?string $val)
 * @method self srclang(?string $val)
 * @method self srcset(?string $val)
 * @method self start(?int $val)
 * @method self step(?float $val)
 * @method self style(?string $property, string $val = null)
 * @method self tabindex(?int $val)
 * @method self target(?string $val)
 * @method self title(?string $val)
 * @method self translate(?string $val)
 * @method self type(?string $val)
 * @method self usemap(?string $val)
 * @method self value(?string $val)
 * @method self width(?int $val)
 * @method self wrap(?string $val)
 */
class Html implements \ArrayAccess, \Countable, \IteratorAggregate, HtmlStringable
{
    use Nette\SmartObject;
    /** @var array<string, mixed>  element's attributes */
    public $attrs = [];
    /** void elements */
    public static $emptyElements = ['img' => 1, 'hr' => 1, 'br' => 1, 'input' => 1, 'meta' => 1, 'area' => 1, 'embed' => 1, 'keygen' => 1, 'source' => 1, 'base' => 1, 'col' => 1, 'link' => 1, 'param' => 1, 'basefont' => 1, 'frame' => 1, 'isindex' => 1, 'wbr' => 1, 'command' => 1, 'track' => 1];
    /** @var array<int, HtmlStringable|string> nodes */
    protected $children = [];
    /** element's name
     * @var string */
    private $name = '';
    /**
     * @var bool
     */
    private $isEmpty = \false;
    /**
     * Constructs new HTML element.
     * @param  array|string $attrs element's attributes or plain text content
     * @return static
     */
    public static function el(?string $name = null, $attrs = null)
    {
        $el = new static();
        $parts = \explode(' ', (string) $name, 2);
        $el->setName($parts[0]);
        if (is_array($attrs)) {
            $el->attrs = $attrs;
        } elseif ($attrs !== null) {
            $el->setText($attrs);
        }
        if (isset($parts[1])) {
            foreach (Strings::matchAll($parts[1] . ' ', '#([a-z0-9:-]+)(?:=(["\'])?(.*?)(?(2)\\2|\\s))?#i') as $m) {
                $el->attrs[$m[1]] = $m[3] ?? \true;
            }
        }
        return $el;
    }
    /**
     * Returns an object representing HTML text.
     * @return static
     */
    public static function fromHtml(string $html)
    {
        return (new static())->setHtml($html);
    }
    /**
     * Returns an object representing plain text.
     * @return static
     */
    public static function fromText(string $text)
    {
        return (new static())->setText($text);
    }
    /**
     * Converts to HTML.
     */
    public final function toHtml() : string
    {
        return $this->render();
    }
    /**
     * Converts to plain text.
     */
    public final function toText() : string
    {
        return $this->getText();
    }
    /**
     * Converts given HTML code to plain text.
     */
    public static function htmlToText(string $html) : string
    {
        return \html_entity_decode(\strip_tags($html), \ENT_QUOTES | \ENT_HTML5, 'UTF-8');
    }
    /**
     * Changes element's name.
     * @return static
     */
    public final function setName(string $name, ?bool $isEmpty = null)
    {
        $this->name = $name;
        $this->isEmpty = $isEmpty ?? isset(static::$emptyElements[$name]);
        return $this;
    }
    /**
     * Returns element's name.
     */
    public final function getName() : string
    {
        return $this->name;
    }
    /**
     * Is element empty?
     */
    public final function isEmpty() : bool
    {
        return $this->isEmpty;
    }
    /**
     * Sets multiple attributes.
     * @return static
     */
    public function addAttributes(array $attrs)
    {
        $this->attrs = \array_merge($this->attrs, $attrs);
        return $this;
    }
    /**
     * Appends value to element's attribute.
     * @param mixed $value
     * @param mixed $option
     * @return static
     */
    public function appendAttribute(string $name, $value, $option = \true)
    {
        if (is_array($value)) {
            $prev = isset($this->attrs[$name]) ? (array) $this->attrs[$name] : [];
            $this->attrs[$name] = $value + $prev;
        } elseif ((string) $value === '') {
            $tmp =& $this->attrs[$name];
            // appending empty value? -> ignore, but ensure it exists
        } elseif (!isset($this->attrs[$name]) || is_array($this->attrs[$name])) {
            // needs array
            $this->attrs[$name][$value] = $option;
        } else {
            $this->attrs[$name] = [$this->attrs[$name] => \true, $value => $option];
        }
        return $this;
    }
    /**
     * Sets element's attribute.
     * @param mixed $value
     * @return static
     */
    public function setAttribute(string $name, $value)
    {
        $this->attrs[$name] = $value;
        return $this;
    }
    /**
     * Returns element's attribute.
     * @return mixed
     */
    public function getAttribute(string $name)
    {
        return $this->attrs[$name] ?? null;
    }
    /**
     * Unsets element's attribute.
     * @return static
     */
    public function removeAttribute(string $name)
    {
        unset($this->attrs[$name]);
        return $this;
    }
    /**
     * Unsets element's attributes.
     * @return static
     */
    public function removeAttributes(array $attributes)
    {
        foreach ($attributes as $name) {
            unset($this->attrs[$name]);
        }
        return $this;
    }
    /**
     * Overloaded setter for element's attribute.
     * @param mixed $value
     */
    public final function __set(string $name, $value) : void
    {
        $this->attrs[$name] = $value;
    }
    /**
     * Overloaded getter for element's attribute.
     * @return mixed
     */
    public final function &__get(string $name)
    {
        return $this->attrs[$name];
    }
    /**
     * Overloaded tester for element's attribute.
     */
    public final function __isset(string $name) : bool
    {
        return isset($this->attrs[$name]);
    }
    /**
     * Overloaded unsetter for element's attribute.
     */
    public final function __unset(string $name) : void
    {
        unset($this->attrs[$name]);
    }
    /**
     * Overloaded setter for element's attribute.
     * @return mixed
     */
    public final function __call(string $m, array $args)
    {
        $p = \substr($m, 0, 3);
        if ($p === 'get' || $p === 'set' || $p === 'add') {
            $m = \substr($m, 3);
            $m[0] = $m[0] | " ";
            if ($p === 'get') {
                return $this->attrs[$m] ?? null;
            } elseif ($p === 'add') {
                $args[] = \true;
            }
        }
        if (\count($args) === 0) {
            // invalid
        } elseif (\count($args) === 1) {
            // set
            $this->attrs[$m] = $args[0];
        } else {
            // add
            $this->appendAttribute($m, $args[0], $args[1]);
        }
        return $this;
    }
    /**
     * Special setter for element's attribute.
     * @return static
     */
    public final function href(string $path, array $query = [])
    {
        if ($query) {
            $query = \http_build_query($query, '', '&');
            if ($query !== '') {
                $path .= '?' . $query;
            }
        }
        $this->attrs['href'] = $path;
        return $this;
    }
    /**
     * Setter for data-* attributes. Booleans are converted to 'true' resp. 'false'.
     * @param mixed $value
     * @return static
     */
    public function data(string $name, $value = null)
    {
        if (\func_num_args() === 1) {
            $this->attrs['data'] = $name;
        } else {
            $this->attrs["data-{$name}"] = \is_bool($value) ? \json_encode($value) : $value;
        }
        return $this;
    }
    /**
     * Sets element's HTML content.
     * @param mixed $html
     * @return static
     */
    public final function setHtml($html)
    {
        $this->children = [(string) $html];
        return $this;
    }
    /**
     * Returns element's HTML content.
     */
    public final function getHtml() : string
    {
        return \implode('', $this->children);
    }
    /**
     * Sets element's textual content.
     * @param mixed $text
     * @return static
     */
    public final function setText($text)
    {
        if (!$text instanceof HtmlStringable) {
            $text = \htmlspecialchars((string) $text, \ENT_NOQUOTES, 'UTF-8');
        }
        $this->children = [(string) $text];
        return $this;
    }
    /**
     * Returns element's textual content.
     */
    public final function getText() : string
    {
        return self::htmlToText($this->getHtml());
    }
    /**
     * Adds new element's child.
     * @param mixed $child
     * @return static
     */
    public final function addHtml($child)
    {
        return $this->insert(null, $child);
    }
    /**
     * Appends plain-text string to element content.
     * @param mixed $text
     * @return static
     */
    public function addText($text)
    {
        if (!$text instanceof HtmlStringable) {
            $text = \htmlspecialchars((string) $text, \ENT_NOQUOTES, 'UTF-8');
        }
        return $this->insert(null, $text);
    }
    /**
     * Creates and adds a new Html child.
     * @param mixed[]|string|null $attrs
     * @return static
     */
    public final function create(string $name, $attrs = null)
    {
        $this->insert(null, $child = static::el($name, $attrs));
        return $child;
    }
    /**
     * Inserts child node.
     * @param \Nette\HtmlStringable|string $child
     * @return static
     */
    public function insert(?int $index, $child, bool $replace = \false)
    {
        $child = $child instanceof self ? $child : (string) $child;
        if ($index === null) {
            // append
            $this->children[] = $child;
        } else {
            // insert or replace
            \array_splice($this->children, $index, $replace ? 1 : 0, [$child]);
        }
        return $this;
    }
    /**
     * Inserts (replaces) child node (\ArrayAccess implementation).
     * @param  int|null  $index  position or null for appending
     * @param  Html|string  $child  Html node or raw HTML string
     */
    public final function offsetSet($index, $child) : void
    {
        $this->insert($index, $child, \true);
    }
    /**
     * Returns child node (\ArrayAccess implementation).
     * @param  int  $index
     * @return \Nette\HtmlStringable|string
     */
    #[\ReturnTypeWillChange]
    public final function offsetGet($index)
    {
        return $this->children[$index];
    }
    /**
     * Exists child node? (\ArrayAccess implementation).
     * @param  int  $index
     */
    public final function offsetExists($index) : bool
    {
        return isset($this->children[$index]);
    }
    /**
     * Removes child node (\ArrayAccess implementation).
     * @param  int  $index
     */
    public function offsetUnset($index) : void
    {
        if (isset($this->children[$index])) {
            \array_splice($this->children, $index, 1);
        }
    }
    /**
     * Returns children count.
     */
    public final function count() : int
    {
        return \count($this->children);
    }
    /**
     * Removes all children.
     */
    public function removeChildren() : void
    {
        $this->children = [];
    }
    /**
     * Iterates over elements.
     * @return \ArrayIterator<int, HtmlStringable|string>
     */
    public final function getIterator() : \ArrayIterator
    {
        return new \ArrayIterator($this->children);
    }
    /**
     * Returns all children.
     */
    public final function getChildren() : array
    {
        return $this->children;
    }
    /**
     * Renders element's start tag, content and end tag.
     */
    public final function render(?int $indent = null) : string
    {
        $s = $this->startTag();
        if (!$this->isEmpty) {
            // add content
            if ($indent !== null) {
                $indent++;
            }
            foreach ($this->children as $child) {
                if ($child instanceof self) {
                    $s .= $child->render($indent);
                } else {
                    $s .= $child;
                }
            }
            // add end tag
            $s .= $this->endTag();
        }
        if ($indent !== null) {
            return "\n" . \str_repeat("\t", $indent - 1) . $s . "\n" . \str_repeat("\t", \max(0, $indent - 2));
        }
        return $s;
    }
    public final function __toString() : string
    {
        return $this->render();
    }
    /**
     * Returns element's start tag.
     */
    public final function startTag() : string
    {
        return $this->name ? '<' . $this->name . $this->attributes() . '>' : '';
    }
    /**
     * Returns element's end tag.
     */
    public final function endTag() : string
    {
        return $this->name && !$this->isEmpty ? '</' . $this->name . '>' : '';
    }
    /**
     * Returns element's attributes.
     * @internal
     */
    public final function attributes() : string
    {
        if (!is_array($this->attrs)) {
            return '';
        }
        $s = '';
        $attrs = $this->attrs;
        foreach ($attrs as $key => $value) {
            if ($value === null || $value === \false) {
                continue;
            } elseif ($value === \true) {
                $s .= ' ' . $key;
                continue;
            } elseif (is_array($value)) {
                if (\strncmp($key, 'data-', 5) === 0) {
                    $value = Json::encode($value);
                } else {
                    $tmp = null;
                    foreach ($value as $k => $v) {
                        if ($v != null) {
                            // intentionally ==, skip nulls & empty string
                            // composite 'style' vs. 'others'
                            $tmp[] = $v === \true ? $k : (is_string($k) ? $k . ':' . $v : $v);
                        }
                    }
                    if ($tmp === null) {
                        continue;
                    }
                    $value = \implode($key === 'style' || !\strncmp($key, 'on', 2) ? ';' : ' ', $tmp);
                }
            } elseif (is_float($value)) {
                $value = \rtrim(\rtrim(\number_format($value, 10, '.', ''), '0'), '.');
            } else {
                $value = (string) $value;
            }
            $q = \strpos($value, '"') !== \false ? "'" : '"';
            $s .= ' ' . $key . '=' . $q . \str_replace(['&', $q, '<'], ['&amp;', $q === '"' ? '&quot;' : '&#39;', '<'], $value) . (\strpos($value, '`') !== \false && \strpbrk($value, ' <>"\'') === \false ? ' ' : '') . $q;
        }
        $s = \str_replace('@', '&#64;', $s);
        return $s;
    }
    /**
     * Clones all children too.
     */
    public function __clone()
    {
        foreach ($this->children as $key => $value) {
            if (is_object($value)) {
                $this->children[$key] = clone $value;
            }
        }
    }
}

🔐 Sid Gifari File Manager Pro