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

Register a CSS stylesheet.


Description Description


Parameters Parameters

$handle

(string) (Required) Name of the stylesheet. Should be unique.

$src

(string) (Required) Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.

$deps

(array) (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'


Top ↑

Return Return

(bool) Whether the style has been registered. True on success, false on failure.


Top ↑

Source Source

File: wp-includes/functions.wp-styles.php

function wp_register_style( $handle, $src, $deps = array(), $ver = false, $media = 'all' ) {
	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );

	return wp_styles()->add( $handle, $src, $deps, $ver, $media );
}

Top ↑

Changelog Changelog

Changelog
Version Description
4.3.0 A return value was added.
2.6.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note content
    Contributed by Ivan Shulev

    Examples
    In a Plugin (outside a PHP class)

    Assumes the Plugin directory is named ‘my-plugin’.
    Assumes the Plugin style sheet is named ‘plugin.css’.

    /**
     * Registers a stylesheet.
     */
    function wpdocs_register_plugin_styles() {
    	wp_register_style( 'my-plugin', plugins_url( 'my-plugin/css/plugin.css' ) );
    	wp_enqueue_style( 'my-plugin' );
    }
    // Register style sheet.
    add_action( 'wp_enqueue_scripts', 'wpdocs_register_plugin_styles' );
    
  2. Skip to note content
    Contributed by Ivan Shulev

    Example
    In a plugin (inside a PHP class)

    Assumes the Plugin class name is ‘my_plugin’.
    Assumes the Plugin directory is named ‘my-plugin’.
    Assumes the Plugin style sheet is named ‘plugin.css’.

    class WPDocs_My_Plugin_Stylesheet {
    
    	/**
    	 * Constructor.
    	 */
    	function __construct() {
    		// Register stylesheet.
    		add_action( 'wp_enqueue_scripts', array( $this, 'register_plugin_styles' ) );
    	}
    
    	/**
    	 * Registers and enqueues stylesheet.
    	 */
    	public function register_plugin_styles() {
    		wp_register_style( 'my-plugin', plugins_url( 'my-plugin/css/plugin.css' ) );
    		wp_enqueue_style( 'my-plugin' );
    	}
    }
    new WPDocs_My_Plugin_Stylesheet();
    

You must log in before being able to contribute a note or feedback.