wp_enqueue_style
Enqueue a CSS stylesheet.
Description
wp_enqueue_style( (string) $handle, (string) $src = '', (array) $deps = array(), (constant) $ver = false, (string) $media = 'all' );
Registers the style if source provided (does NOT overwrite) and enqueues.
Parameters (5)
- 0. $handle (string)
- Name of the stylesheet. Should be unique.
- 1. $src — Optional. (string) =>
''
- Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory. Default empty.
- 2. $deps — Optional. (array) =>
array()
- An array of registered stylesheet handles this stylesheet depends on. Default empty array.
- 3. $ver — Optional. (constant) =>
false
- 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.
- 4. $media — Optional. (string) =>
'all'
- 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).
Usage
if ( !function_exists( 'wp_enqueue_style' ) ) { require_once ABSPATH . WPINC . '/functions.wp-styles.php'; } // Name of the stylesheet. Should be unique. $handle = ''; // Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory. // Default empty. $src = ''; // Optional. An array of registered stylesheet handles this stylesheet depends on. Default empty array. $deps = array(); $ver = false; $media = 'all'; // NOTICE! Understand what this does before running. $result = wp_enqueue_style($handle, $src, $deps, $ver, $media);
Defined (1)
The function is defined in the following location(s).
- /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 );
- }