wp_register_style( string $handle, string|false $src, string[] $deps = array(), string|bool|null $ver = false, string $media = 'all' ): bool
Registers a CSS stylesheet.
Contents
Description
See also
Parameters
-
$handle
string Required -
Name of the stylesheet. Should be unique.
-
$src
string|false Required -
Full URL of the stylesheet, or path of the stylesheet relative to the WordPress root directory.
If source is set to false, stylesheet is an alias of other stylesheets it depends on. -
$deps
string[] Optional -
An array of registered stylesheet handles this stylesheet depends on.
Default:
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:
false
-
$media
string Optional -
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'
Return
bool Whether the style has been registered. True on success, false on failure.
Source
File: wp-includes/functions.wp-styles.php
.
View all references
function wp_register_style( $handle, $src, $deps = array(), $ver = false, $media = 'all' ) {
_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );
return wp_styles()->add( $handle, $src, $deps, $ver, $media );
}
Changelog
Version | Description |
---|---|
4.3.0 | A return value was added. |
2.6.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
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’.
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’.
Note that Google Fonts has changed their URLs, so when embedding multiple font families only one will be loaded. The change is “fundamentally incompatible with how the rest of the world uses query variables and thus PHP itself”.
The fix is to set
null
on the$version
parameter, which prevents the URL from being parsed and the additional font families lost.Trac ticket: https://core.trac.wordpress.org/ticket/49742