wp_enqueue_style( string $handle, string $src = '', string[] $deps = array(), string|bool|null $ver = false, string $media = 'all' )

Description

Parameters

$handlestring

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

$depsstring[]optional

An array of registered stylesheet handles this stylesheet depends on. Default empty array.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'

Uses · 2

• _wp_scripts_maybe_doing_it_wrong()Helper function to output a _doing_it_wrong message when applicable.
• wp_styles()Initializes $wp_styles if it has not been set.

Used by · 50

• Custom_Background::admin_load()Sets up the enqueue for the CSS & JavaScript files.
• Custom_Image_Header::css_includes()Sets up the enqueue for the CSS files.
• Twenty_Fourteen_Ephemera_Widget::enqueue_scripts()Enqueues scripts.
• Twenty_Twenty_One_Custom_Colors::editor_custom_color_variables()Editor custom color variables.
• Twenty_Twenty_One_Dark_Mode::enqueue_scripts()Enqueues scripts and styles.
• WP_Admin_Bar::initialize()Initializes the admin bar.
• WP_Block::render()Generates the render output for the block.
• WP_Customize_Color_Control::enqueue()Enqueue scripts/styles for the color picker.
• WP_Customize_Manager::customize_preview_init()Prints JavaScript settings.
• WP_Customize_Nav_Menus::enqueue_scripts()Enqueues scripts and styles for Customizer pane.
• WP_Customize_Widgets::enqueue_scripts()Enqueues scripts and styles for Customizer panel and export data to JavaScript.
• WP_Duotone::output_footer_assets()Outputs all necessary SVG for duotone filters, CSS for classic themes.

Source

View on Trac ↗View on GitHub ↗

173function wp_enqueue_style( $handle, $src = '', $deps = array(), $ver = false, $media = 'all' ) {174	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );175 176	$wp_styles = wp_styles();177 178	if ( $src ) {179		$_handle = explode( '?', $handle );180		$wp_styles->add( $_handle[0], $src, $deps, $ver, $media );181	}182 183	$wp_styles->enqueue( $handle );184}

History

Introduced in 2.6.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.0.4 tag, from src/wp-includes/functions.wp-styles.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.