northrook / html-element
用于生成HTML元素及其属性的类集合。
dev-main
2024-09-30 09:28 UTC
Requires
- php: >=8.3
- northrook/core: dev-main
Requires (Dev)
- northrook/dev-env: dev-main
- phpstan/phpstan: @stable
- voku/portable-ascii: ^2.0
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>