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 225 (+88 into the body)

   Filters the HTML link tag of an enqueued style.

2. 2
   apply_filters( style_loader_tag )filterline 245 (+108 into the body)

   Filters the HTML link tag of an enqueued style.

Uses · 7

• 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_HTML_Tag_Processor::__construct()Constructor.
• 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 ↗

137	public function do_item( $handle, $group = false ) {138		if ( ! parent::do_item( $handle ) ) {139			return false;140		}141 142		$obj = $this->registered[ $handle ];143		if ( $obj->extra['conditional'] ?? false ) {144 145			return false;146		}147		if ( null === $obj->ver ) {148			$ver = '';149		} else {150			$ver = $obj->ver ? $obj->ver : $this->default_version;151		}152 153		if ( isset( $this->args[ $handle ] ) ) {154			$ver = $ver ? $ver . '&amp;' . $this->args[ $handle ] : $this->args[ $handle ];155		}156 157		$src          = $obj->src;158		$inline_style = $this->print_inline_style( $handle, false );159 160		if ( $inline_style ) {161			$processor = new WP_HTML_Tag_Processor( '<style></style>' );162			$processor->next_tag();163			$processor->set_attribute( 'id', "{$handle}-inline-css" );164			$processor->set_modifiable_text( "\n{$inline_style}\n" );165			$inline_style_tag = "{$processor->get_updated_html()}\n";166		} else {167			$inline_style_tag = '';168		}169 170		if ( $this->do_concat ) {171			if ( is_string( $src ) && $this->in_default_dir( $src ) && ! isset( $obj->extra['alt'] ) ) {172				$this->concat         .= "$handle,";173				$this->concat_version .= "$handle$ver";174 175				$this->print_code .= $inline_style;176 177				return true;178			}179		}180 181		$media = $obj->args ?? 'all';182 183		// A single item may alias a set of items, by having dependencies, but no source.184		if ( ! $src ) {185			if ( $inline_style_tag ) {186				if ( $this->do_concat ) {187					$this->print_html .= $inline_style_tag;188				} else {189					echo $inline_style_tag;190				}191			}192 193			return true;194		}195 196		$href = $this->_css_href( $src, $obj->ver, $handle );197		if ( ! $href ) {198			return true;199		}200 201		$rel   = isset( $obj->extra['alt'] ) && $obj->extra['alt'] ? 'alternate stylesheet' : 'stylesheet';202		$title = $obj->extra['title'] ?? '';203 204		$tag = sprintf(205			"<link rel='%s' id='%s-css'%s href='%s' media='%s' />\n",206			$rel,207			esc_attr( $handle ),208			$title ? sprintf( " title='%s'", esc_attr( $title ) ) : '',209			$href,210			esc_attr( $media )211		);212 213		/**214		 * Filters the HTML link tag of an enqueued style.215		 *216		 * @since 2.6.0

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 7.1.0 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.