云策 WordPress 开发者社区

函数文档

wp_is_block_theme()

查看官方原文 ↗
💡 云策文档标注

概述

wp_is_block_theme() 函数用于检测当前激活的主题是否为基于块的主题（block-based theme）。它通过检查主题是否定义了 index.html 块模板来实现，返回布尔值。

关键要点

  • 函数返回布尔值，指示当前主题是否为块主题
  • 内部调用 wp_get_theme()->is_block_theme() 进行检测
  • 在主题目录注册前调用会触发 _doing_it_wrong() 警告，并返回 false
  • 建议在 after_theme_setup 钩子之后使用，以确保正确性
  • 函数自 WordPress 5.9.0 版本引入

注意事项

函数名称可能略有误导，它实际检查的是全站编辑（FSE）主题，通过 index.html 模板定义判断。调用时机不当可能导致错误提示。

📄 原文内容

Returns whether the active theme is a block-based theme or not.

Return

bool Whether the active theme is a block-based theme or not.

Source

function wp_is_block_theme() {
	if ( empty( $GLOBALS['wp_theme_directories'] ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'This function should not be called before the theme directory is registered.' ), '6.8.0' );
		return false;
	}

	return wp_get_theme()->is_block_theme();
}

View all references View on Trac View on GitHub

Uses Description
wp_get_theme()wp-includes/theme.php

Gets a WP_Theme object for a theme.
__()wp-includes/l10n.php

Retrieves the translation of $text.
_doing_it_wrong()wp-includes/functions.php

Marks something as being incorrectly called.

Show 1 moreShow less

Used by Description
wp_load_classic_theme_block_styles_on_demand()wp-includes/script-loader.php

Adds hooks to load block styles on demand in classic themes.
WP_Script_Modules::add_hooks()wp-includes/class-wp-script-modules.php

Adds the hooks to print the import map, enqueued script modules and script module preloads.
wp_get_post_content_block_attributes()wp-includes/block-editor.php

Retrieves Post Content block attributes from the current post template.
WP_Duotone::output_footer_assets()wp-includes/class-wp-duotone.php

Outputs all necessary SVG for duotone filters, CSS for classic themes.
_wp_block_theme_register_classic_sidebars()wp-includes/widgets.php

Registers the previous theme’s sidebars for the block themes.
wp_enqueue_global_styles_custom_css()wp-includes/deprecated.php

Enqueues the global styles custom css defined via theme.json.
wp_enqueue_stored_styles()wp-includes/script-loader.php

Fetches, processes and compiles stored core styles, then combines and renders them to the page.
wp_enqueue_block_support_styles()wp-includes/script-loader.php

Hooks inline styles in the proper place, depending on the active theme.
_add_default_theme_supports()wp-includes/theme.php

Adds default theme supports for block themes when the ‘after_setup_theme’ action fires.
wp_admin_bar_edit_site_menu()wp-includes/admin-bar.php

Adds the “Edit Site” link to the Toolbar.
_add_plugin_file_editor_to_tools()wp-admin/menu.php

Adds the ‘Plugin File Editor’ menu item after the ‘Themes File Editor’ in Tools for block themes.
WP_REST_Sidebars_Controller::prepare_item_for_response()wp-includes/rest-api/endpoints/class-wp-rest-sidebars-controller.php

Prepares a single sidebar output for response.
wp_enable_block_templates()wp-includes/theme-templates.php

Enables the block templates (editor mode) for themes with theme.json by default.
get_block_editor_settings()wp-includes/block-editor.php

Returns the contextualized block editor settings for a selected editor context.
wp_enqueue_global_styles()wp-includes/script-loader.php

Enqueues the global styles defined via theme.json.
wp_admin_bar_customize_menu()wp-includes/admin-bar.php

Adds the “Customize” link to the Toolbar.
wp_welcome_panel()wp-admin/includes/dashboard.php

Displays a welcome panel to introduce users to WordPress.
_add_themes_utility_last()wp-admin/menu.php

Adds the ‘Theme File Editor’ menu item to the bottom of the Appearance (non-block themes) or Tools (block themes) menu.
WP_Customize_Manager::customize_preview_settings()wp-includes/class-wp-customize-manager.php

Prints JavaScript settings for preview frame.
WP_Customize_Manager::__construct()wp-includes/class-wp-customize-manager.php

Constructor.
wp_widgets_add_menu()wp-includes/functions.php

Appends the Widgets menu to the themes main menu.

Show 16 moreShow less

Changelog

Version Description
5.9.0 Introduced.

User Contributed Notes