检索主题中文件的URL。

原型

get_theme_file_uri( string $file = '' )

描述

在模板目录之前搜索样式表目录,以便从父主题继承的主题可以覆盖一个文件。

参数

$file (string) (Optional)  要在样式表目录中搜索的文件。

返回值

(string)  文件的URL。

源文件

路径:wp-includes/link-template.php

<?php
...
function get_theme_file_uri( $file = '' ) {
	$file = ltrim( $file, '/' );
	if ( empty( $file ) ) {
		$url = get_stylesheet_directory_uri();
	} elseif ( file_exists( get_stylesheet_directory() . '/' . $file ) ) {
		$url = get_stylesheet_directory_uri() . '/' . $file;
	} else {
		$url = get_template_directory_uri() . '/' . $file;
	}
	/**
	 * Filters the URL to a file in the theme.
	 *
	 * @since 4.7.0
	 *
	 * @param string $url  The file URL.
	 * @param string $file The requested file to search for.
	 */
	return apply_filters( 'theme_file_uri', $url, $file );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/get_theme_file_uri/