函数文档

wp_html_split()

💡 云策文档标注

概述

wp_html_split() 是一个 WordPress 核心函数,用于将文本中的 HTML 元素和注释分离出来,返回格式化后的数组。

关键要点

  • 函数接受一个必需的字符串参数 $input,表示需要格式化的文本。
  • 返回一个字符串数组,包含分离后的 HTML 元素、注释和文本部分。
  • 内部使用 preg_split() 和 get_html_split_regex() 正则表达式进行分割。
  • 自 WordPress 4.2.4 版本引入,主要用于处理 HTML 内容,如替换标签内字符或处理短代码。

代码示例

function wp_html_split( $input ) {
    return preg_split( get_html_split_regex(), $input, -1, PREG_SPLIT_DELIM_CAPTURE );
}

📄 原文内容

Separates HTML elements and comments from the text.

Parameters

$inputstringrequired
The text which has to be formatted.

Return

string[] Array of the formatted text.

Source

function wp_html_split( $input ) {
	return preg_split( get_html_split_regex(), $input, -1, PREG_SPLIT_DELIM_CAPTURE );
}

Changelog

Version Description
4.2.4 Introduced.