` *(默认标签 = div)* |
| `.btn.large` | `
` |
| `a[href="/x"][target=_blank]` | `
` |
| `input[type=text][required]` | `` *(void 元素)* |
### 属性与子节点
```php
// 第一个额外参数若是关联数组，则视为属性
Dom::make('input', ['type' => 'text', 'value' => 'a&b']);
// 否则额外参数都是子节点
Dom::make('ul', Dom::make('li', 'one'), Dom::make('li', 'two'));
```
`class` 和 `style` 是**合并**而非替换：
```php
$attrs = new Attrs(['class' => 'a', 'style' => 'color:red']);
$attrs->attachClass('b c')->patchStyle('font-size:12px');
(string)$attrs; // class="a b c" style="color:red;font-size:12px;"
```
### 原始（受信任）HTML
```php
Dom::make('div', Dom::trust($userProvidedMarkup)); // 不会被转义
```
> `Dom::trust()` 仅用于你**完全信任**的内容。不可信输入**必须**作为普通字符串传入，将自动转义。
### 组件（可调用对象）
```php
$card = function (Attrs $attrs, array $children) {
return Dom::make('section.card', $attrs, ...$children);
};
Dom::make($card, ['data-x' => 1], Dom::make('p', 'body'));
```
### 全局辅助函数
```php
echo dom('div#x.btn', 'Hi')->render(); // 等同于 Dom::make(...)
$attrs = attrs_merge(['class' => 'a', 'style' => 'color:red'], ['class' => 'b c']);
$classes = classes_attach('a b', 'd x');
$classes = classes_detach('a b', 'b c x');
$styles = styles_patch('display: none', 'font-size:12px', ['display' => 'block']);
```
## 架构
```
src/
├── Dom/ # PSR-4 命名空间 Fakis\LightDom
│ ├── Classes.php # class 属性集合（规范化、attach、detach）
│ ├── Styles.php # style 属性集合（规范化、patch）
│ ├── Attrs.php # 通用属性容器（委托给 class 与 style）
│ ├── Raw.php # 标记：受信任、不转义的 HTML
│ └── Dom.php # Dom 工厂方法、选择器解析、渲染器
└── helpers.php # 全局 dom() 函数（autoload.files）
```
| 类 | 职责 |
|-----------|------------------------------------------------------|
| `Classes` | 规范化 / 去重 / attach / detach CSS 类名 |
| `Styles` | 规范化 / 合并 CSS 声明 |
| `Attrs` | 统一的属性包；委托处理 `class` 与 `style` |
| `Raw` | `readonly` 标记：选择不转义 |
| `Dom` | 不可变 DOM 节点 + `make()` + `render()` + 选择器解析 |
## 开发
```bash
composer install
composer test # 运行 PHPUnit
composer cs-check # PSR-12 代码风格检查
composer cs-fix # 自动修复
```
## 安全
所有动态内容默认都被转义。唯一的安全入口是 `Dom::trust()` / `Raw`，它被有意设计得非常显式，方便做 XSS 审查。
## 协议
MIT — 见 [LICENSE](LICENSE)。