Question

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

Enqueues or directly prints a stylesheet link to the specified CSS file.

---

description

"Intelligently" decides to enqueue or to print the CSS file. If the ‘wp_print_styles’ action has not yet been called, the CSS file will be enqueued. If the ‘wp_print_styles’ action has been called, the CSS link will be printed. Printing may be forced by passing true as the $force_echo (second) parameter.

For backward compatibility with WordPress 2.3 calling method: If the $file (first) parameter does not correspond to a registered CSS file, we assume $file is a file relative to wp-admin/ without its ".css" extension. A stylesheet link to that generated URL is printed.

---

参数

$file

(string) (Optional) Style handle name or file name (without ".css" extension) relative to wp-admin/. Defaults to 'wp-admin'.

Default value: 'wp-admin'

$force_echo

(bool) (Optional) Force the stylesheet link to be printed rather than enqueued.

Default value: false

---

源代码

File: wp-includes/general-template.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" );
	}
}

---

更新日志

Version	description
2.3.0	Introduced.

---

相关函数

Uses

• wp-includes/functions.wp-styles.php: wp_styles()
• wp-includes/formatting.php: esc_url()
• wp-includes/general-template.php: wp_admin_css_uri()
• wp-includes/general-template.php: wp_admin_css
• wp-includes/l10n.php: is_rtl()
• wp-includes/functions.wp-styles.php: wp_print_styles()
• wp-includes/functions.wp-styles.php: wp_enqueue_style()
• wp-includes/plugin.php: did_action()
• wp-includes/plugin.php: apply_filters()
Show 4 more uses Hide more uses

---

Used By

• wp-admin/install.php: display_header()

---

User Contributed Notes