README

这是一个非常简单的 HTML 5 生成库。

安装

此库可以通过 Composer 安装

composer require brick/html

此库需要 PHP 7.1 或更高版本。

此库仍在开发中。

当前版本编号为 0.x.y。当引入非破坏性变更（添加新方法、优化现有代码等）时，y 增加一。

当引入破坏性变更时，总是开始一个新的 0.x 版本周期。

因此，将项目锁定到特定的发布周期（如 0.1.*）是安全的。

如果您需要升级到较新的发布周期，请查看发布历史以获取每个后续 0.x.0 版本引入的变更列表。

此库包含一个名为 Tag 的类，它代表一个 HTML 标签。您可以使用标签名构建一个 Tag

use Brick\Html\Tag;

$div = new Tag('div');

您可以将一个可选的关联数组属性传递给构造函数

$div = new Tag('div', [
    'id' => 'main',
    'class' => 'block',
]);

或者您可以在之后设置属性

$tag->setAttributes([
    'id' => 'main',
    'class' => 'block',
]);

或者

$tag->setAttribute('id', 'main')
    ->setAttribute('class', 'block');

您也可以删除属性

$tag->removeAttribute('id');

您可以为 Tag 设置内容，前提是它不是一个 void 标签，如 <br>、<input> 等。如果您尝试修改 void 标签的内容，您将获得一个 LogicException。

您可以为设置或附加纯文本内容

$tag->setTextContent('Hello, world!');
$tag->appendTextContent("\nWhat's up?");

或设置/附加 HTML 内容

$tag->setHtmlContent('Hello, <b>world!</b>');
$tag->appendHtmlContent("<br>What's up?");

您还可以附加另一个 Tag

$tag->append($otherTag);

您可以为 Tag 删除内容

$tag->empty();

您可以检查一个 Tag 是否具有空内容

$tag->isEmpty(); // boolean

您可以使用其 render() 方法或将其转换为字符串来渲染一个标签

echo $tag; // will output something like: <div id="main">Hello, world!</div>

所有文本（属性、内容）都应有效 UTF-8。