wp_admin_css_uri()
云策文档标注
概述
wp_admin_css_uri() 函数用于生成 WordPress 后台 CSS 文件的 URL，支持版本查询参数和过滤器钩子。
关键要点
- 函数接受一个参数 $file，表示相对于 wp-admin/ 目录的文件路径（不带 .css 扩展名）。
- 在安装模式下（WP_INSTALLING 定义时），URL 基于当前目录；否则使用 admin_url() 生成。
- 通过 add_query_arg() 添加版本参数，并应用 wp_admin_css_uri 过滤器进行自定义。
代码示例
function wp_admin_css_uri( $file = 'wp-admin' ) {
if ( defined( 'WP_INSTALLING' ) ) {
$_file = "./$file.css";
} else {
$_file = admin_url( "$file.css" );
}
$_file = add_query_arg( 'version', get_bloginfo( 'version' ), $_file );
return apply_filters( 'wp_admin_css_uri', $_file, $file );
}注意事项
- 相关函数包括 get_bloginfo(), add_query_arg(), admin_url(), apply_filters()。
- 主要用于 wp_admin_css() 函数，自 WordPress 2.3.0 版本引入。
原文内容
Displays the URL of a WordPress admin CSS file.
Description
See also
- WP_Styles::_css_href(): and its ‘style_loader_src’ filter.
Parameters
$filestringrequired-
file relative to wp-admin/ without its “.css” extension.
Source
function wp_admin_css_uri( $file = 'wp-admin' ) {
if ( defined( 'WP_INSTALLING' ) ) {
$_file = "./$file.css";
} else {
$_file = admin_url( "$file.css" );
}
$_file = add_query_arg( 'version', get_bloginfo( 'version' ), $_file );
/**
* Filters the URI of a WordPress admin CSS file.
*
* @since 2.3.0
*
* @param string $_file Relative path to the file with query arguments attached.
* @param string $file Relative path to the file, minus its ".css" extension.
*/
return apply_filters( 'wp_admin_css_uri', $_file, $file );
}
Hooks
- apply_filters( ‘wp_admin_css_uri’, string $_file, string $file )
-
Filters the URI of a WordPress admin CSS file.
Changelog
| Version | Description |
|---|---|
| 2.3.0 | Introduced. |