wp_dequeue_style( string $handle )

User Contributed Notes

1. Skip to note 3 content

   Marius L. J. 6 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note

   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_style for 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_style function, 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 of 10, so we just need a value of 11 to 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.
2. Skip to note 4 content

   vee 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

   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_style will be enqueue anyway.

   • If you have dependent style you can do following: 1. Check if “dependent” style is loaded at all, and then if it is loaded: 1.1. You dequeue “dependent” style 1.2. OPTIONAL – deregister it so you can enqueue it separately if needed 1.3. Enqueue it as independent 1.4. Dequeue “parent style” 1.5. Enqueue “parent style” again so it is “moved down” toward section and eventually loaded last… 2. ELSE – “dependent” style is NOT loaded 2.1. Just dequeue “parent style” so you can manipulate it’s “load position” 2.2. Enqueue “parent style” again so it is “moved down” toward section and eventually loaded last

     peterbra 3 years ago