云策 WordPress 开发者社区

函数文档

get_stylesheet_directory()

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

概述

get_stylesheet_directory() 函数用于获取当前活动主题的样式表目录路径，返回字符串类型。当使用子主题时，返回子主题目录路径，而非父主题目录。

关键要点

  • 返回活动主题的样式表目录绝对路径，不包含尾部斜杠
  • 若使用子主题，返回子主题目录路径；获取父主题目录应使用 get_template_directory()
  • 可通过 apply_filters('stylesheet_directory', ...) 钩子过滤路径
  • 相关函数包括 get_stylesheet_directory_uri() 用于获取 URI，get_template_directory() 用于父主题路径

代码示例

// 示例输出：/home/user/public_html/wp-content/themes/my_theme
$stylesheet_dir = get_stylesheet_directory();

注意事项

  • 路径不包含尾部斜杠，使用时需注意拼接
  • 优先使用函数而非 STYLESHEETPATH 常量，以支持过滤钩子
  • 在子主题环境中，确保理解与父主题路径的区别
📄 原文内容

Retrieves stylesheet directory path for the active theme.

Return

string Path to active theme’s stylesheet directory.

More Information

Source

function get_stylesheet_directory() {
	$stylesheet     = get_stylesheet();
	$theme_root     = get_theme_root( $stylesheet );
	$stylesheet_dir = "$theme_root/$stylesheet";

	/**
	 * Filters the stylesheet directory path for the active theme.
	 *
	 * @since 1.5.0
	 *
	 * @param string $stylesheet_dir Absolute path to the active theme.
	 * @param string $stylesheet     Directory name of the active theme.
	 * @param string $theme_root     Absolute path to themes directory.
	 */
	return apply_filters( 'stylesheet_directory', $stylesheet_dir, $stylesheet, $theme_root );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘stylesheet_directory’, string $stylesheet_dir, string $stylesheet, string $theme_root )

Filters the stylesheet directory path for the active theme.

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

Retrieves path to themes directory.
get_stylesheet()wp-includes/theme.php

Retrieves name of the current stylesheet.
apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Show 1 moreShow less

Used by Description
WP_Debug_Data::get_wp_active_theme()wp-admin/includes/class-wp-debug-data.php

Gets the WordPress active theme section of the debug data.
wp_set_template_globals()wp-includes/template.php

Set up the globals used for template loading.
get_block_asset_url()wp-includes/blocks.php

Gets the URL to a block asset.
wp_theme_has_theme_json()wp-includes/global-styles-and-settings.php

Checks whether a theme or its parent has a theme.json file.
WP_Theme_JSON_Resolver::get_style_variations()wp-includes/class-wp-theme-json-resolver.php

Returns the style variations defined by the theme.
wp_generate_block_templates_export_file()wp-includes/block-template-utils.php

Creates an export of the current templates and template parts from the site editor at the specified path in a ZIP file.
_get_block_template_file()wp-includes/block-template-utils.php

Retrieves the template file from the theme for a given slug.
_get_block_templates_files()wp-includes/block-template-utils.php

Retrieves the template files from the theme.
WP_Theme_JSON_Resolver::get_file_path_from_theme()wp-includes/class-wp-theme-json-resolver.php

Builds the path to the given file and checks that it is readable.
locate_block_template()wp-includes/block-template.php

Finds a block template with equal or higher specificity than a given PHP template file.
resolve_block_template()wp-includes/block-template.php

Returns the correct ‘wp_template’ to render for the request template type.
WP_Customize_Manager::prepare_starter_content_attachments()wp-includes/class-wp-customize-manager.php

Prepares starter content attachments.
get_theme_file_path()wp-includes/link-template.php

Retrieves the path of a file in the theme.
get_theme_file_uri()wp-includes/link-template.php

Retrieves the URL of a file in the theme.
_load_textdomain_just_in_time()wp-includes/l10n.php

Loads plugin and theme text domains just-in-time.
get_editor_stylesheets()wp-includes/theme.php

Retrieves any registered editor stylesheet URLs.
validate_current_theme()wp-includes/theme.php

Checks that the active theme has the required files.
get_locale_stylesheet_uri()wp-includes/theme.php

Retrieves the localized stylesheet URI.
load_child_theme_textdomain()wp-includes/l10n.php

Loads the child theme’s translated strings.
wp_templating_constants()wp-includes/default-constants.php

Defines templating-related WordPress constants.

Show 15 moreShow less

Changelog

Version Description
6.4.2 Memoization removed.
6.4.0 Memoizes filter execution so that it only runs once for the current theme.
1.5.0 Introduced.

User Contributed Notes

  2. Skip to note 5 content


    Andrew Schultz


    You must log in to vote on the helpfulness of this noteVote results for this note: -2You must log in to vote on the helpfulness of this note

    You can also use the constant “STYLESHEETPATH” in replacement of get_stylesheet_directory()

  3. Skip to note 6 content


    Matthias Baier


    You must log in to vote on the helpfulness of this noteVote results for this note: -3You must log in to vote on the helpfulness of this note

    get_stylesheet_directory() retrieves the child-theme’s directory.
    If you want to retrieve the parent-theme’s directory use get_template_directory() instead or even better loacate_template() – This way WordPress automatically uses your child themes directory to look for your resource – if there is a child-theme-file present it will use this one instead. No need for enqueuing anything.