将样式表链接排队或直接打印到指定的CSS文件。

原型

wp_admin_css( string $file = 'wp-admin', bool $force_echo = false )

描述

“智能”决定排队或打印CSS文件。如果尚未调用’wp_print_styles’操作,则CSS文件将被排队。如果已调用’wp_print_styles’操作,则将打印CSS链接。可以通过传递true作为$ force_echo(第二个)参数来强制打印。

参数

$file (string) (Optional)  相对于wp-admin /的样式句柄名称或文件名(不带“.css”扩展名)。默认为’wp-admin’。

$force_echo (bool) (Optional)  强制打印样式表链接而不是排队。

源文件

路径:wp-includes/general-template.php

<?php
...
function wp_admin_css( $file = 'wp-admin', $force_echo = false ) {
	// For backward compatibility
	$handle = 0 === strpos( $file, 'css/' ) ? substr( $file, 4 ) : $file;
	if ( wp_styles()->query( $handle ) ) {
		if ( $force_echo || did_action( 'wp_print_styles' ) ) // we already printed the style queue. Print this one immediately
			wp_print_styles( $handle );
		else // Add to style queue
			wp_enqueue_style( $handle );
		return;
	}
	/**
	 * Filters the stylesheet link to the specified CSS file.
	 *
	 * If the site is set to display right-to-left, the RTL stylesheet link
	 * will be used instead.
	 *
	 * @since 2.3.0
	 * @param string $stylesheet_link HTML link element for the stylesheet.
	 * @param string $file            Style handle name or filename (without ".css" extension)
	 *                                relative to wp-admin/. Defaults to 'wp-admin'.
	 */
	echo apply_filters( 'wp_admin_css', "<link rel='stylesheet' href='" . esc_url( wp_admin_css_uri( $file ) ) . "' type='text/css' />n", $file );
	if ( function_exists( 'is_rtl' ) && is_rtl() ) {
		/** This filter is documented in wp-includes/general-template.php */
		echo apply_filters( 'wp_admin_css', "<link rel='stylesheet' href='" . esc_url( wp_admin_css_uri( "$file-rtl" ) ) . "' type='text/css' />n", "$file-rtl" );
	}
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_admin_css/