wp_enqueue_style( string $handle, string $src = '', string[] $deps = array(), string|bool|null $ver = false, string $media = 'all' )
Enqueue a CSS stylesheet.
Description
Registers the style if source provided (does NOT overwrite) and enqueues.
See also
Parameters
- $handle
-
(string) (Required) Name of the stylesheet. Should be unique.
- $src
-
(string) (Optional) Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.
Default value: ''
- $deps
-
(string[]) (Optional) An array of registered stylesheet handles this stylesheet depends on.
Default value: array()
- $ver
-
(string|bool|null) (Optional) String specifying stylesheet version number, if it has one, which is added to the URL as a query string for cache busting purposes. If version is set to false, a version number is automatically added equal to current installed WordPress version. If set to null, no version is added.
Default value: false
- $media
-
(string) (Optional) The media for which this stylesheet has been defined. Accepts media types like 'all', 'print' and 'screen', or media queries like '(orientation: portrait)' and '(max-width: 640px)'.
Default value: 'all'
More Information
Usage
A safe way to add/enqueue a stylesheet file to the WordPress generated page.
wp_enqueue_style( $handle, $src, $deps, $ver, $media );
Notes
- If you are going to use some jQuery UI features you might have to provide your own CSS file: WordPress core does not have a full jQuery UI theme!
- Default styles that are loaded via WordPress Core can be discerned via the source code on the default styles page.
Source
File: 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__, $handle ); $wp_styles = wp_styles(); if ( $src ) { $_handle = explode( '?', $handle ); $wp_styles->add( $_handle[0], $src, $deps, $ver, $media ); } $wp_styles->enqueue( $handle ); }
Changelog
Version | Description |
---|---|
2.6.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_enqueue_style