WP_Dependencies::dequeue() WordPress Method
The WP_Dependencies::dequeue() method is used to remove a registered script from the queue. This is useful for deregistering scripts that are no longer needed or for conditionally loading scripts.
WP_Dependencies::dequeue( string|string[] $handles ) #
Dequeue an item or items.
Description
Decodes handles and arguments, then dequeues handles and removes arguments from the class property $args.
Parameters
- $handles
(string|string[])(Required)Item handle (string) or item handles (array of strings).
Source
File: wp-includes/class.wp-dependencies.php
public function dequeue( $handles ) {
foreach ( (array) $handles as $handle ) {
$handle = explode( '?', $handle );
$key = array_search( $handle[0], $this->queue, true );
if ( false !== $key ) {
// Reset all dependencies so they must be recalculated in recurse_deps().
$this->all_queued_deps = null;
unset( $this->queue[ $key ] );
unset( $this->args[ $handle[0] ] );
} elseif ( array_key_exists( $handle[0], $this->queued_before_register ) ) {
unset( $this->queued_before_register[ $handle[0] ] );
}
}
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 2.6.0 | Moved from WP_Scripts. |
| 2.1.0 | Introduced. |