WP_Styles::do_item( string $handle, int|false $group = false ): bool

Parameters

$handlestring

The style's registered handle.

$groupint|falseoptional

Group level: level (int), no groups (false). Default false.Default: false

Return

bool

True on success, false on failure.

Hooks fired · 2

2 hooks fire while WP_Styles::do_item() runs, in this order:

1. 1
   apply_filters( style_loader_tag )filterline 245 (+94 into the body)

   Filters the HTML link tag of an enqueued style.

2. 2
   apply_filters( style_loader_tag )filterline 266 (+115 into the body)

   Filters the HTML link tag of an enqueued style.

Uses · 6

• esc_attr()Escaping for HTML attributes.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• WP_Dependencies::do_item()Processes a dependency.
• WP_Styles::print_inline_style()Prints extra CSS styles of a registered stylesheet.
• WP_Styles::in_default_dir()Whether a handle's source is in a default directory.
• WP_Styles::_css_href()Generates an enqueued style's fully-qualified URL.

Source

View on Trac ↗View on GitHub ↗

151	public function do_item( $handle, $group = false ) {152		if ( ! parent::do_item( $handle ) ) {153			return false;154		}155 156		$obj = $this->registered[ $handle ];157		if ( $obj->extra['conditional'] ?? false ) {158 159			return false;160		}161		if ( null === $obj->ver ) {162			$ver = '';163		} else {164			$ver = $obj->ver ? $obj->ver : $this->default_version;165		}166 167		if ( isset( $this->args[ $handle ] ) ) {168			$ver = $ver ? $ver . '&amp;' . $this->args[ $handle ] : $this->args[ $handle ];169		}170 171		$src          = $obj->src;172		$inline_style = $this->print_inline_style( $handle, false );173 174		if ( $inline_style ) {175			$inline_style_tag = sprintf(176				"<style id='%s-inline-css'%s>\n%s\n</style>\n",177				esc_attr( $handle ),178				$this->type_attr,179				$inline_style180			);181		} else {182			$inline_style_tag = '';183		}184 185		if ( $this->do_concat ) {186			if ( $this->in_default_dir( $src ) && ! isset( $obj->extra['alt'] ) ) {187				$this->concat         .= "$handle,";188				$this->concat_version .= "$handle$ver";189 190				$this->print_code .= $inline_style;191 192				return true;193			}194		}195 196		if ( isset( $obj->args ) ) {197			$media = $obj->args;198		} else {199			$media = 'all';200		}201 202		// A single item may alias a set of items, by having dependencies, but no source.203		if ( ! $src ) {204			if ( $inline_style_tag ) {205				if ( $this->do_concat ) {206					$this->print_html .= $inline_style_tag;207				} else {208					echo $inline_style_tag;209				}210			}211 212			return true;213		}214 215		$href = $this->_css_href( $src, $ver, $handle );216		if ( ! $href ) {217			return true;218		}219 220		$rel   = isset( $obj->extra['alt'] ) && $obj->extra['alt'] ? 'alternate stylesheet' : 'stylesheet';221		$title = isset( $obj->extra['title'] ) ? $obj->extra['title'] : '';222 223		$tag = sprintf(224			"<link rel='%s' id='%s-css'%s href='%s'%s media='%s' />\n",225			$rel,226			esc_attr( $handle ),227			$title ? sprintf( " title='%s'", esc_attr( $title ) ) : '',228			$href,229			$this->type_attr,230			esc_attr( $media )

History

Introduced in 2.6.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-includes/class-wp-styles.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.