函数名:tidy::root()
适用版本:PHP 5 >= 5.2.0, PHP 7, PHP 8
函数描述:tidy::root() 方法用于获取或设置 Tidy 所处理的 HTML/XHTML 文档的根元素。
用法:
获取根元素: tidy::root() 方法可以不带任何参数调用,用于获取当前 Tidy 实例正在处理的文档的根元素。返回值为根元素的节点对象。
示例代码:
$tidy = new tidy(); $tidy->parseString('<html><body><h1>Hello World!</h1></body></html>'); $root = $tidy->root(); echo $root->name; // 输出: html
设置根元素: tidy::root() 方法也可以接受一个参数,用于设置 Tidy 实例正在处理的文档的根元素。参数可以是一个节点对象或节点名称的字符串。
示例代码:
$tidy = new tidy(); $tidy->parseString('<p>Some text</p>'); $root = $tidy->root(); $root->name = 'div'; echo $tidy; // 输出: <div><p>Some text</p></div>
注意事项:
- tidy::root() 方法需要在调用 tidy::parseString() 或 tidy::parseFile() 方法之后使用,否则将返回空值。
- 如果 tidy::root() 方法在调用 tidy::parseString() 或 tidy::parseFile() 方法之前调用,则返回的根元素将是 Tidy 实例的默认根元素。