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/