钩子文档

admin_print_styles

💡 云策文档标注

概述

admin_print_styles 是一个 WordPress 动作钩子,在所有管理页面打印样式时触发。它主要用于添加自定义内联 CSS,但不应用于排队样式或脚本。

关键要点

  • admin_print_styles 钩子在所有管理页面打印样式时触发,允许开发者注入自定义内联 CSS。
  • 不应使用此钩子来排队样式或脚本,应使用 admin_enqueue_scripts 钩子代替。
  • 此钩子自 WordPress 2.6.0 版本引入,常用于自定义管理界面样式。

代码示例

add_action( 'admin_print_styles', 'wpdocs_admin_inline_css' );
/**
 * 添加内联样式
 */
function wpdocs_admin_inline_css() {
    echo '<style>table.wp-list-table .column-thumb { width: 52px; text-align: center; white-space: nowrap; }</style>';
}

注意事项

确保仅用于内联 CSS 输出,避免在此钩子中排队外部资源,以免影响性能或导致冲突。


📄 原文内容

Fires when styles are printed for all admin pages.

More Information

admin_print_styles should not be used to enqueue styles or scripts on the admin pages. Use <a title="Plugin API/Action Reference/admin enqueue scripts" href="https://developer.wordpress.org/reference/hooks/admin_enqueue_scripts/">admin_enqueue_scripts</a> instead.

Source

do_action( 'admin_print_styles' );

Changelog

Version Description
2.6.0 Introduced.

User Contributed Notes

  1. Skip to note 4 content

    Add custom inline CSS into the admin area. You must add style tag.

    add_action( 'admin_print_styles', 'wpdocs_admin_column_styles' );
    /**
     * Adds Column inline style
     */
    function wpdocs_admin_column_styles() {
    	$custom_css = 'table.wp-list-table .column-thumb { 
    		width: 52px; 
    		text-align: center;
    		white-space: nowrap;
    	}';
    		
    	echo '<style>' . $custom_css . '</style>';
    }