wordpress标签说明,wp:query-title

wordpress标签说明,wp:query-title

核心解释

<!-- wp:query-title {"type":"archive"} /--> 是一个 WordPress 块编辑器(Gutenberg) 的块标记,它的唯一作用是:自动显示当前存档页(Archive Page)的标题

详细分解

  1. <!-- wp:query-title />

    • wp:query-title 是“查询标题”块(Query Title Block)的标识符。

    • 这个块专门用于在基于“查询循环”的模板(如存档页、分类页、搜索结果页等)中动态显示标题。

  2. {"type":"archive"}

    • 这是一个JSON格式的属性参数,它指定了标题的“类型”或“风格”。

    • "type":"archive" 告诉WordPress使用为“存档页”预设的标题格式。这通常意味着标题前会有一个默认的前缀,比如“Archives: ”。

  3. /-->

    • 这是一个自闭合标签,表示这个块内部不包含任何其他子内容。

功能与输出

  • 它在哪里工作?这个块在存档页模板中有效,例如:

    • 文章分类页(Category)

    • 文章标签页(Tag)

    • 作者文章页(Author)

    • 日期存档页(Date Archive)

    • 自定义 taxonomy 存档页

    • 搜索结果页(Search Results)

  • 它会显示什么?它的输出内容完全由当前访问的页面决定:

    • 分类页: 分类:科技 (中文) 或 Category: Tech (英文)

    • 标签页: 标签:WordPress 或 Tag: WordPress

    • 作者页: 作者:张三 或 Author: John Doe

    • 搜索页: 搜索结果:关键词 或 Search results for: Keyword

    • 日期存档页: 2024年10月 或 October 2024

实际应用场景

这段代码通常出现在WordPress块主题的模板文件中,例如:

  • archive.html (通用存档模板)

  • category.html (分类模板)

  • author.html (作者模板)

它的作用是确保这些页面的标题区域能自动、正确地显示,而无需手动为每个分类或作者单独设置。

示例: 在一个 category.html 模板中,你可能会看到这样的结构:

<!-- wp:template-part {"slug":"header"} /--> <!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} --> <main class="wp-block-group">    <!-- wp:query-title {"type":"archive"} /-->    <!-- wp:post-template -->        <!-- 这里是显示文章列表的块 -->    <!-- /wp:post-template --> </main> <!-- /wp:group --> <!-- wp:template-part {"slug":"footer"} /-->

总结

简单来说,<!-- wp:query-title {"type":"archive"} /--> 是一个智能的占位符,它能自动获取并渲染出当前存档页面的上下文标题,是构建动态、可复用模板的关键组件之一。

THE END
喜欢就支持以下吧
点赞 0
评论 抢沙发
友好交流,请勿发纯表情,请勿灌水,会被封号喔
提交