wp_dequeue_style( string $handle )
Remove a previously enqueued CSS stylesheet.
Description
See also
Parameters
- $handle
-
(string) (Required) Name of the stylesheet to be removed.
Source
File: wp-includes/functions.wp-styles.php
function wp_dequeue_style( $handle ) {
_wp_scripts_maybe_doing_it_wrong( __FUNCTION__, $handle );
wp_styles()->dequeue( $handle );
}
Expand full source code Collapse full source code View on Trac View on GitHub
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |
User Contributed Notes
You must log in before being able to contribute a note or feedback.
To dequeue a style, it has to have been registered before you try to remove it. The best way to achieve this is to set a higher priority for your event and then run it.
Presume that a theme has the following code:
add_action( 'wp_enqueue_scripts', 'mywptheme_register_styles' ); function mywptheme_register_styles() { wp_enqueue_style( 'mywptheme', get_stylesheet_uri() ); }The above registers a style with the handle `mywptheme` (See the documentation for
wp_enqueue_stylefor more details on how to use it).Now in our plugin, or child theme, we want to remove this stylesheet from being loaded.
This can be achieved with the
wp_dequeue_stylefunction, and by making sure it runs at a lower priority (higher number) than the original function. The original function did not have a priority set, so it will use the default value of10, so we just need a value of11to run later.add_action( 'wp_enqueue_scripts', 'mywptheme_child_deregister_styles', 11 ); function mywptheme_child_deregister_styles() { wp_dequeue_style( 'mywptheme' ); }Take note that we are using the same style handle as the original registration used.
The function
wp_dequeue_style()cannot dequeue the handle that is in dependencies list.For example: I have enqueue this.
add_action( 'wp_enqueue_scripts', 'wpdocs_myplugin_enqueue' ); function wpdocs_myplugin_enqueue() { wp_enqueue_style( 'wpdocs_myplugin_style', plugin_dir_url(__FILE__) . 'assets/css/style.css', array( 'wpdocs_otherplugin_style' ) ); }If I try to dequeue the handle name
wpdocs_otherplugin_style, then it will not work.add_action( 'wp_enqueue_scripts', 'wpdocs_myplugin2_dequeue', 100 ); function wpdocs_myplugin2_dequeue() { wp_dequeue_style( 'wpdocs_otherplugin_style' ); }The handle name
wpdocs_otherplugin_stylewill be enqueue anyway.