WordPress 中 get_stylesheet_directory_uri() 函数的用法详解

使用 get_stylesheet_directory_uri() 函数可以返回当前主题的样式表目录的 URI。它可以用来在你的 WordPress 网站中包含来自主题的样式表或其他资源。

例如，你可以使用 get_stylesheet_directory_uri() 函数来在你的 WordPress 网站中包含样式表：

<link rel="stylesheet" type="text/css" href="<?php echo get_stylesheet_directory_uri(); ?>/style.css">

这将包含当前主题的样式表目录中的 style.css 文件。

你也可以使用 get_stylesheet_directory_uri() 函数来包含来自主题的其他资源，如图像或 JavaScript 文件。例如：

<img src="<?php echo get_stylesheet_directory_uri(); ?>/images/logo.png">

<script src="<?php echo get_stylesheet_directory_uri(); ?>/js/main.js"></script>

请注意，get_stylesheet_directory_uri() 函数仅在 WordPress 主题的上下文中有效。如果你尝试在主题之外使用它，它将不会返回有效的 URI。

使用 get_stylesheet_directory_uri() 时的注意事项

1. 如果你使用的是子主题，get_stylesheet_directory_uri() 将返回子主题的样式表目录的 URI，而不是父主题的样式表目录的 URI。要获取父主题的样式表目录的 URI，可以使用 get_template_directory_uri() 函数。
2. 如果你使用的是主题框架，如 Genesis 或 Underscores，get_stylesheet_directory_uri() 可能不会返回主题的实际样式表目录的 URI。相反，它可能会返回相对于主题框架文件的 URI。在这种情况下，可能需要使用不同的函数，如 wp_get_theme()->get_stylesheet_directory_uri()，来获取主题的实际样式表目录的 URI。
3. 如果你使用了缓存插件，可能需要在对主题的样式表或其他资源进行更改后清除缓存，以使这些更改生效。这是因为缓存插件可能会提供缓存版本的资源，而不是最新版本的资源。
4. 如果你使用了压缩或合并主题样式表的插件，可能需要使用不同的函数，如 wp_enqueue_style()，在主题中包含样式表。这是因为 get_stylesheet_directory_uri() 返回原始样式表文件的 URI，而压缩或合并版本的文件可能具有不同的 URI。
5. 如果你使用的是 WordPress 多站点安装，get_stylesheet_directory_uri() 将返回当前站点的样式表目录的 URI。如果需要获取其他站点的样式表目录的 URI，可以使用 get_blog_option() 函数来检索该站点的 stylesheet_directory 选项。

使用 get_stylesheet_directory_uri() 的示例：

1. 包含样式表：

<link rel="stylesheet" type="text/css" href="<?php echo get_stylesheet_directory_uri(); ?>/style.css">

2. 包含自定义字体：

<link href="<?php echo get_stylesheet_directory_uri(); ?>/fonts/custom-font.woff2" rel="stylesheet">

3. 在模板文件中包含图像：

<img src="<?php echo get_stylesheet_directory_uri(); ?>/images/header-image.jpg">

4. 在页脚中包含 JavaScript 文件：

<?php wp_enqueue_script( 'custom-script', get_stylesheet_directory_uri() . '/js/custom-script.js', array(), '1.0.0', true ); ?>

5. 在自定义函数中使用 get_stylesheet_directory_uri()：

function custom_function() {
  $css_url = get_stylesheet_directory_uri() . '/css/custom.css';
  // 对 CSS URL 进行操作
}