概述

_wp_render_title_tag() 是一个 WordPress 函数，用于在主题支持 title-tag 功能时输出文档标题标签。它通过调用 wp_get_document_title() 来获取并显示当前页面的标题。

关键要点

• 函数仅在当前主题支持 'title-tag' 功能时执行，否则直接返回。
• 使用 wp_get_document_title() 获取文档标题，并输出为 HTML 标题标签。
• 自 WordPress 4.1.0 引入，4.4.0 版本改进了标题输出，替代了旧的 wp_title() 函数。

代码示例

function _wp_render_title_tag() {
    if ( ! current_theme_supports( 'title-tag' ) ) {
        return;
    }

    echo '<title>' . wp_get_document_title() . '</title>' . "n";
}

注意事项

• 确保主题通过 add_theme_support('title-tag') 启用 title-tag 支持，否则此函数不会输出任何内容。
• 此函数是 WordPress 核心的一部分，通常不需要直接调用，而是通过 wp_head 动作钩子自动执行。