目录
wp_enqueue_style() 用于向 WordPress 主题页面中引入样式文件,可以有效地避免在多个代码块中重复调用样式文件的问题。可以配合 wp_register_style() 使用,使用方法与 wp_enqueue_script() 类似。
该函数的语法如下:
wp_enqueue_style( string $handle, string $src = \'\', array $deps = array(), string|bool|null $ver = false, string $media = \'all\' )
$handle
:字符串(必填)。样式文件名称,必须是唯一值。
$src
:字符串或布尔值(可选)。完整的样式文件路径或基于WordPress根目录的相对路径。如果资源为false,则样式文件为基于其他样式文件的别名。
$deps
:数组(可选)。样式文件将在该数组所包含的其他样式文件之后处理。
$ver
:字符串、布尔值或空值(可选)。指定样式文件版本号,将其作为查询字符串添加到 URL 中以清除缓存。 如果设置为 false ,则自动设置当前安装的 WordPress 版本为版本号。 如果设置为 null ,则不添加任何版本。
$in_footer
:布尔值(可选)。该样式表针对何种媒体设备使用,支持“all”、’print’ 以及 ‘screen’ ,或者 ‘(orientation: portrait)’ 与 ‘(max-width: 640px)’等。
注意:使用该函数则必须使用 <?php wp_head();?>
与 <?php wp_footer();?>
获取页眉页脚,否则样式文件将无法引入!!!
该函数定义在 wp-includes/functions.wp-styles.php 文件中,具体代码如下:
function wp_enqueue_style( $handle, $src = \'\', $deps = array(), $ver = false, $media = \'all\' ) {
_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );
$wp_styles = wp_styles();
if ( $src ) {
$_handle = explode(\'?\', $handle);
$wp_styles->add( $_handle[0], $src, $deps, $ver, $media );
}
$wp_styles->enqueue( $handle );
}
参考文档:https://developer.wordpress.org/reference/functions/wp_enqueue_style/