函数文档

print_late_styles()

💡 云策文档标注

概述

print_late_styles() 函数用于打印在 HTML head 部分之后排队(queued)的样式(styles)。它处理全局 $wp_styles 对象,并可通过过滤器控制是否打印这些“迟到”的样式。

关键要点

  • 函数打印那些在 HTML head 部分之后才排队的样式,通常用于页脚(footer)处理。
  • 它依赖于全局变量 $wp_styles 和 $concatenate_scripts,并调用 script_concat_settings() 来设置脚本和样式的连接(concatenation)和压缩(compression)设置。
  • 函数使用 apply_filters('print_late_styles', true) 过滤器,允许开发者通过钩子(hook)控制是否打印这些样式,默认值为 true。
  • 函数返回 $wp_styles->done 数组,表示已处理的样式,或者无返回值(void)。
  • 相关函数包括 WP_Styles::do_footer_items()、WP_Styles::reset() 和 _print_styles(),用于处理页脚项目、重置属性和打印样式。

代码示例

function print_late_styles() {
    global $wp_styles, $concatenate_scripts;

    if ( ! ( $wp_styles instanceof WP_Styles ) ) {
        return;
    }

    script_concat_settings();
    $wp_styles->do_concat = $concatenate_scripts;
    $wp_styles->do_footer_items();

    if ( apply_filters( 'print_late_styles', true ) ) {
        _print_styles();
    }

    $wp_styles->reset();
    return $wp_styles->done;
}

注意事项

  • 函数在 WordPress 3.3.0 版本中引入,主要用于内部处理,开发者通常通过钩子或相关函数间接使用。
  • 确保 $wp_styles 是 WP_Styles 的实例,否则函数会提前返回,避免错误。
  • 过滤器 print_late_styles 允许自定义打印行为,例如在特定条件下禁用打印。

📄 原文内容

Prints the styles that were queued too late for the HTML head.

Return

array|void

Source

function print_late_styles() {
	global $wp_styles, $concatenate_scripts;

	if ( ! ( $wp_styles instanceof WP_Styles ) ) {
		return;
	}

	script_concat_settings();
	$wp_styles->do_concat = $concatenate_scripts;
	$wp_styles->do_footer_items();

	/**
	 * Filters whether to print the styles queued too late for the HTML head.
	 *
	 * @since 3.3.0
	 *
	 * @param bool $print Whether to print the 'late' styles. Default true.
	 */
	if ( apply_filters( 'print_late_styles', true ) ) {
		_print_styles();
	}

	$wp_styles->reset();
	return $wp_styles->done;
}

Hooks

apply_filters( ‘print_late_styles’, bool $print )

Filters whether to print the styles queued too late for the HTML head.

Changelog

Version Description
3.3.0 Introduced.