balanceTags()平衡补齐标签

目录

描述

译文

函数仅在被要求以及选项被设为校正标签时会对标签进行自动校正。

只要对标签进行校正,就会用到'use_balanceTags'选项。在校正标签前,$force参数和 'use_balanceTags'选项值都必须为true。

原文

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

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

调用 force_balance_tags() 进行补全。

balanceTags() 描述

用法

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

balanceTags() 用法

参数

$text

(string) (必填) 将  标签的文 

默认值: None

$force

(boolean) (可选) 如果该 数为 true,则忽略use_balanceTags option 中的值。

默认值: false

balanceTags() 参数

返回值

(string) 

补齐之后的  

balanceTags() 返回值

示例

不完整的LI标签:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

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

输出的 HTML:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

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

balanceTags() 示例

注意

  • 'use_balanceTags' 选 在 WordPress > 撰写 > 格式 > “让 WordPress 自动校正  误的 XHTML 代码” 中设置。
  • balanceTags() 注意

    历史

    添加于 版本: 0.71

    balanceTags() 历史

    源文件

    balanceTags() 函数的代码位于 wp-includes/formatting.php.

    /* ----------------------------------
     * wordpress之魂 © http://wphun.com
     * ---------------------------------- */
    /**
     * Balances tags if forced to, or if the 'use_balanceTags' option is set to true.
     *
     * @since 0.71
     *
     * @param string $text  Text to be balanced
     * @param bool   $force If true, forces balancing, ignoring the value of the option. Default false.
     * @return string Balanced text
     */
    function balanceTags( $text, $force = false ) {
    	if ( $force || get_option('use_balanceTags') == 1 ) {
    		return force_balance_tags( $text );
    	} else {
    		return $text;
    	}
    }
    
    

    balanceTags() 源文件