On this page
wp_register_style( string $handle, string|false $src, string[] $deps = array(), string|bool|null $ver = false, string $media = 'all' ): bool
Register a CSS stylesheet.
Description
See also
Parameters
$handlestring Required-
Name of the stylesheet. Should be unique.
$srcstring|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. $depsstring[] Optional-
An array of registered stylesheet handles this stylesheet depends on.
Default:
array() $verstring|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 $mediastring 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 );
}
Related
Uses
| Uses | Description |
|---|---|
| wp_styles() wp-includes/functions.wp-styles.php | Initialize $wp_styles if it has not been set. |
Used By
| Used By | Description |
|---|---|
| wp_enqueue_classic_theme_styles() wp-includes/script-loader.php | Loads classic theme styles on classic themes in the frontend. |
| wp_enqueue_stored_styles() wp-includes/script-loader.php | Fetches, processes and compiles stored core styles, then combines and renders them to the page. |
| _wp_theme_json_webfonts_handler() wp-includes/script-loader.php | Runs the theme.json webfonts handler. |
| wp_enqueue_global_styles_css_custom_properties() wp-includes/script-loader.php | Function that enqueues the CSS Custom Properties coming from theme.json. |
| wp_enqueue_block_style() wp-includes/script-loader.php | Enqueues a stylesheet for a specific block. |
| wp_enqueue_global_styles() wp-includes/script-loader.php | Enqueues the global styles defined via theme.json. |
| register_block_style_handle() wp-includes/blocks.php | Finds a style handle for the block metadata field. It detects when a path to file was provided and registers the style under automatically generated handle name. It returns unprocessed style handle otherwise. |
Changelog
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_register_style