云策 WordPress 开发者社区

函数文档

print_admin_styles()

查看官方原文 ↗
💡 云策文档标注

概述

print_admin_styles() 函数用于在 WordPress 管理页面头部打印样式队列，并返回已打印样式的句柄数组。它涉及全局脚本连接设置和过滤器控制打印行为。

关键要点

  • 函数在管理页面 HTML head 中输出样式队列，返回已打印样式的句柄数组。
  • 使用全局变量 $concatenate_scripts 和 wp_styles() 对象处理样式连接和打印。
  • 通过 apply_filters('print_admin_styles', true) 过滤器控制是否打印样式，默认值为 true。
  • 相关函数包括 wp_styles()、WP_Styles::reset()、script_concat_settings() 和 apply_filters()。
  • 自 WordPress 2.8.0 版本引入。

代码示例

function print_admin_styles() {
	global $concatenate_scripts;

	$wp_styles = wp_styles();

	script_concat_settings();
	$wp_styles->do_concat = $concatenate_scripts;
	$wp_styles->do_items( false );

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

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

注意事项

  • 函数依赖于全局变量 $concatenate_cripts 和 wp_styles 对象，确保在调用前已正确初始化。
  • 通过 'print_admin_styles' 过滤器可以自定义是否打印样式，开发者可添加过滤器回调修改默认行为。
  • 返回值为数组，包含已打印样式的句柄，便于后续处理或调试。
📄 原文内容

Prints the styles queue in the HTML head on admin pages.

Return

string[] Handles of the styles that were printed.

Source

function print_admin_styles() {
	global $concatenate_scripts;

	$wp_styles = wp_styles();

	script_concat_settings();
	$wp_styles->do_concat = $concatenate_scripts;
	$wp_styles->do_items( false );

	/**
	 * Filters whether to print the admin styles.
	 *
	 * @since 2.8.0
	 *
	 * @param bool $print Whether to print the admin styles. Default true.
	 */
	if ( apply_filters( 'print_admin_styles', true ) ) {
		_print_styles();
	}

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

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘print_admin_styles’, bool $print )

Filters whether to print the admin styles.

Uses Description
wp_styles()wp-includes/functions.wp-styles.php

Initializes $wp_styles if it has not been set.
WP_Styles::reset()wp-includes/class-wp-styles.php

Resets class properties.
script_concat_settings()wp-includes/script-loader.php

Determines the concatenation and compression settings for scripts and styles.
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Show 1 moreShow less

Changelog

Version Description
2.8.0 Introduced.