wp_enqueue_stored_styles

函数
wp_enqueue_stored_styles ( $options = array() )
参数
  • (array) $options { Optional. An array of options to pass to wp_style_engine_get_stylesheet_from_context(). Default empty array. @type bool $optimize Whether to optimize the CSS output, e.g., combine rules. Default is `false`. @type bool $prettify Whether to add new lines and indents to output. Default is the test of whether the global constant `SCRIPT_DEBUG` is defined. }
    Required:
    Default: array()
返回值
  • (void)
定义位置
相关方法
wp_enqueue_stylewp_enqueue_global_styleswp_enqueue_block_stylewp_enqueue_classic_theme_styleswp_enqueue_block_support_styles
引入
6.1.0
弃用
-

wp_enqueue_stored_styles: 这个函数用于在WordPress中排查存储的样式。存储的样式是保存在网站数据库中的样式,而不是硬编码在一个样式表中: 这个函数可以用来为网站的排版、颜色和布局等查询存储的样式。

获取、处理和编译存储的核心样式,然后将它们组合并渲染到页面上。

样式是通过样式引擎API存储的。

function wp_enqueue_stored_styles( $options = array() ) {
	$is_block_theme   = wp_is_block_theme();
	$is_classic_theme = ! $is_block_theme;

	/*
	 * For block themes, this function prints stored styles in the header.
	 * For classic themes, in the footer.
	 */
	if (
		( $is_block_theme && doing_action( 'wp_footer' ) ) ||
		( $is_classic_theme && doing_action( 'wp_enqueue_scripts' ) )
	) {
		return;
	}

	$core_styles_keys         = array( 'block-supports' );
	$compiled_core_stylesheet = '';
	$style_tag_id             = 'core';
	// Adds comment if code is prettified to identify core styles sections in debugging.
	$should_prettify = isset( $options['prettify'] ) ? true === $options['prettify'] : defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG;
	foreach ( $core_styles_keys as $style_key ) {
		if ( $should_prettify ) {
			$compiled_core_stylesheet .= "/**n * Core styles: $style_keyn */n";
		}
		// Chains core store ids to signify what the styles contain.
		$style_tag_id             .= '-' . $style_key;
		$compiled_core_stylesheet .= wp_style_engine_get_stylesheet_from_context( $style_key, $options );
	}

	// Combines Core styles.
	if ( ! empty( $compiled_core_stylesheet ) ) {
		wp_register_style( $style_tag_id, false, array(), true, true );
		wp_add_inline_style( $style_tag_id, $compiled_core_stylesheet );
		wp_enqueue_style( $style_tag_id );
	}

	// Prints out any other stores registered by themes or otherwise.
	$additional_stores = WP_Style_Engine_CSS_Rules_Store::get_stores();
	foreach ( array_keys( $additional_stores ) as $store_name ) {
		if ( in_array( $store_name, $core_styles_keys, true ) ) {
			continue;
		}
		$styles = wp_style_engine_get_stylesheet_from_context( $store_name, $options );
		if ( ! empty( $styles ) ) {
			$key = "wp-style-engine-$store_name";
			wp_register_style( $key, false, array(), true, true );
			wp_add_inline_style( $key, $styles );
			wp_enqueue_style( $key );
		}
	}
}

常见问题

FAQs
查看更多 >