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.
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. |