Enqueues a CSS stylesheet.

Description

Registers the style if source provided (does NOT overwrite) and enqueues.

See also

• WP_Dependencies::add()
• WP_Dependencies::enqueue()

Parameters

$handlestringrequired

Name of the stylesheet. Should be unique.

$srcstringoptional

Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.

Default:''

$depsstring[]optional

An array of registered stylesheet handles this stylesheet depends on.

Default:array()

$verstring|bool|nulloptional

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:false

$mediastringoptional

The media for which this stylesheet has been defined.
Default 'all'. Accepts media types like 'all', 'print' and 'screen', or media queries like ‘(orientation: portrait)’ and ‘(max-width: 640px)’.

Default:'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

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 );
}

View all references View on Trac View on GitHub

Changelog