WordPress 6.2 引入了WP_HTML_Tag_Processor –一个供块作者在PHP中调整块标记中的HTML 标签属性的工具。它是新 HTML 处理API中的第一个组件。
在 WordPress 中更新 HTML 一直需要使用不舒服的工具。正则表达式很困难并且容易出现各种错误。DOMDocument占用大量资源，无法正确处理现代 HTML，并且在许多托管平台上不可用。
WP_HTML_Tag_Processor（标签处理器）迈出了弥合这一差距的第一步。
标签处理器可以可靠地更新 HTML 属性
标签处理器找到特定的标签并可以更改其属性。下面是在 HTML 块中的第一个img标签上设置alt属性的示例。
$html = '
';
$p = new WP_HTML_Tag_Processor( $html );
if ( $p->next_tag() ) {
$p->set_attribute( 'alt', 'Husky in the snow' );
}
echo $p->get_updated_html();
// Output:
// 该next_tag()方法移动到 HTML 中的下一个可用标签，但也接受标签名称、CSS类或两者以查找特定标签。根据 HTML 规范，标签和属性名称的查找不区分大小写，但 CSS 类名称区分。
if ( $p->next_tag( array( 'tag_name' => 'DIV', 'class_name' => 'block-GROUP' ) ) ) {
$p->remove_class( 'block-group' );
$p->add_class( 'wp-block-group' );
}默认情况下操作是安全的：
- 删除一个属性而不首先检查它是否存在，
- 添加一个可能已经存在的 CSS 类，
- 设置一个属性值而不确保它不会复制现有的值。
您不再需要担心您的代码会将
HTML;
$p = new WP_HTML_Tag_Processor( $ugly_html );
if ( $p->next_tag( 'div' ) ) {
$p->add_class( 'bold' );
}
echo $p->get_updated_html();
// Output:
//
//
标签处理器的运行速度足以在关键的热代码路径中运行，并且几乎不会产生内存开销。在 WordPress 6.2 中，它取代了依赖正则表达式和字符串搜索来执行类似更新的容易出错的代码。
要更高级地使用标签处理器，请阅读大量的课堂文档并学习如何……
- …设置书签以重新访问已扫描和修改的文档部分。
- …
除了开始标签之外，还可以访问结束标签。
进一步的考虑
Tag Processor 不做很多事情：它不构建 DOM 文档树、查找嵌套标签或更新标签的内部 HTML 或内部文本。继续开发与 HTML 相关的新 API，未来的 WordPress 版本将建立在这项工作的基础上，以允许从 PHP 中访问块的所有属性（如果块提供block.json文件），使用 CSS 选择器查找标签，并修改HTML具有新标签、删除标签和更新的内部标记的结构。
您可以通过Gutenberg GitHub Repo上的这个概述问题跟上进一步的发展。
发表回复