alex-yashin/php-simple-html

description

1.0.0 2022-06-17 08:31 UTC

Requires

• php: >=7.2.0
• ext-json: *

Requires (Dev)

• phpunit/phpunit: 6.*

MIT

• Alex Yashin

• php
• html

README

Класс для генерации HTML-кода. Базовые методы взяты из Yii2 (класс BaseHtml, из которого убраны все специфичные для Yii2 методы, имеющие сложные зависимости).

Дополнен следующими методами:

Html::nest

Html::nest($path, $content = '', $rootOptions = [])

Генерирует цепочку вложенных Html-тегов по шаблону, похожему на xpath.

echo Html::nest('div#my-wrapper/a#my.link[href=#][title=my link]')
//<div id="my-wrapper"><a id="my" class="link" href="#" title="my link"></a></div>

Упоминания тега div может быть опущено, если есть ID, класс или аттрибуты. Параметр $content размещается в содержимом самого глубокого тега цепочки. Отношение соседства на одном уровне вложенности задается через символ +, цепочка продолжается от замыкающего тега в соседстве.

echo Html::nest('.step/.circle+p', 10) 
//<div class="step"><div class="circle"></div><p>10</p></div>

Аттрибут может быть записан без значения, тогда значение будет равно имени аттрибута

echo Html::nest('div/span[disabled]', 'hello!');
//<div><span disabled="disabled">hello!</span></div>

Параметр $rootOptions дополняет аттрибуты внешнего тега. Синтаксис такой же, как и в Html::tag

echo Html::nest('.step/.circle+p', 10, ['class' => 'active'])
//<div class="step active"><div class="circle"></div><p>10</p></div>

Html::zz

Html::zz($template, ...$items)

Более сложный шаблонизатор, который работает не только с одной цепочкой вложенных тегов, но и может моделировать сложное дерево тегов. Для этого отношение иерархии задаются с помощью скобок, а места для подстановок задаются символами %. Отношение соседства задаются как и в случае с nest через символ +.

echo Html::zz('.circle([data-name=%]+.round%+p)+span%', 'step', 10, 20);
//<div class="circle"><div data-name="step"></div><div class="round">10</div><p></p></div><span>20</span>

Использовать можно и для генерации одного тега с подстановками для аттрибутов

echo Html::zz('input.quantity-field[type=number][name=quantity][step=1][readonly][data-sku=%]', 'SKU');
//<input type="number" class="quantity-field" name="quantity" readonly="readonly" step="1" data-sku="SKU">

Html::br

Просто выводит тег <br>

echo Html::br();
//<br>

Html::li

Html::li($content = '', $options = []);

Генерирует тег <li>

echo Html::li('test', ['class' => 'active']);
//<li class="active">test</li>