wp_print_styles( string|bool|array $handles = false ): string[]

Displays styles that are in the $handles queue.

Description

Passing an empty array to $handles prints the queue, passing an array with one string prints that style, and passing an array of strings prints those styles.

Parameters

$handlesstring|bool|arrayoptional
Styles to be printed. Default 'false'.

Default:false

Return

string[] On success, an array of handles of processed WP_Dependencies items; otherwise, an empty array.

Source

function wp_print_styles( $handles = false ) {
	global $wp_styles;

	if ( '' === $handles ) { // For 'wp_head'.
		$handles = false;
	}

	if ( ! $handles ) {
		/**
		 * Fires before styles in the $handles queue are printed.
		 *
		 * @since 2.6.0
		 */
		do_action( 'wp_print_styles' );
	}

	_wp_scripts_maybe_doing_it_wrong( __FUNCTION__ );

	if ( ! ( $wp_styles instanceof WP_Styles ) ) {
		if ( ! $handles ) {
			return array(); // No need to instantiate if nothing is there.
		}
	}

	return wp_styles()->do_items( $handles );
}

Hooks

do_action( ‘wp_print_styles’ )

Fires before styles in the $handles queue are printed.

Changelog

VersionDescription
2.6.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.