northrook/html-element

用于生成HTML元素及其属性的类集合。

dev-main 2024-09-30 09:28 UTC

This package is auto-updated.

Last update: 2024-09-30 10:28:04 UTC


README

生成HTML元素及其属性。

此包背后的动机是提供一个简单的方式来生成具有合理默认值的HTML元素,同时比DOMDocument类更轻量。

元素可以嵌套以创建复杂的HTML结构,但与DOMDocument不同,它不提供完全遍历DOM树的方法。

这是一个故意的设计决策,以保持包的轻量和高效。

重要

此包仍在开发中。

虽然它被认为是MVP(最小可行产品)并且稳定,但它可能还会经历破坏性变更。

注意

文档仍在编写中。

安装

composer require northrook/html-element

用法

可以使用 Element 类创建新元素

namespace Northrook\HTML\Element;

$basic = new Element( content: 'Hello World!' );

echo $basic;
<div>Hello World!</div>

可以使用 $content 参数嵌套元素。它接受字符串、元素和这两种类型的数组。

重要

Element 类不会转义提供的 $content,因此请确保在传递之前或稍后进行转义。

echo new Element( 'h1', [ 'class' => 'example classes' ], $basic );
<h1 class="example classes">
    <div>Hello World!</div>
</h1>
$button = new Element(
    tag        : 'button',
    attributes : [ 'id' => 'Save Action', 'class' => 'btn icon' ],
    content    : [
        new Element( 'i', content: '<svg ... </svg>' ),
        'Save',
    ]
);

echo $button;
<button id="save-action" type="button" class="btn icon">
    <i>...</i>
    Save
</button>

许可证

MIT