WordPress 常用函数 / balanceTags

简介

根据 forced 参数或者 use_balanceTags 选项平衡补齐标签。

'use_balanceTags' 选项或者 $forced 参数任何一个设置为 true,该函数就会补齐文本的标签。

调用 force_balance_tags()进行补全。

用法

<?php balanceTags( $text, $force ); ?>

参数

$text
(string) (required) 将补齐标签的文本
Default: 无

$force
(boolean) (optional) 如果该参数为 true,则忽略use_balanceTags option 中的值。
Default: false

返回值

(string)
补齐之后的标签

实例

<?php
$html = '<ul>
  <li>this
  <li>is
  <li>a
  <li>list
</ul>';
echo balanceTags($html, true);
?>

输出的 HTML:

<ul>
  <li>this
  </li><li>is
  </li><li>a
  </li><li>list
</li></ul>

注解

  • 'use_balanceTags' 选项在 WordPress > 撰写 > 格式 > “让 WordPress 自动校正嵌套错误的 XHTML 代码” 中设置。

修改记录

Since: 0.71

源文件

wp-includes/formatting.php.