“术语查询”区块显示分类法术语(例如分类目录、标签或自定义分类法)的列表或网格。它最适合用于模板(例如“分类目录”索引或目录页面),当您希望列出术语并设计每个术语的显示方式时尤其有用。
要求
- WordPress 6.9 或更高版本。
- 用于在站点编辑器中编辑模板的区块主题。
- 您希望显示的分类法必须是公开的,并且可在编辑器中使用(启用 show_in_rest)。
“术语查询”区块的结构

区块检查器快速概览了“术语查询”区块的结构。每个部分都可让您访问不同的设置:
- 术语查询:配置查询参数。
- 术语模板:选择内容的显示方式,可以是列表或网格格式。
- 术语名称:显示术语名称。
- 术语描述:显示术语描述。
- 术语计数:显示每个术语的结果数量。
将“术语查询”区块添加到模板
- 转到“外观” > “编辑器”。
- 打开您希望显示术语的模板(例如自定义的“分类目录”模板)。
- 将光标放在所需位置。
- 打开区块插入器(+),搜索“术语查询”,然后选择它。
区块配置
添加“术语查询”区块后,您会看到两个选项:

这些变体提供了两种不同的布局选项:
- 名称:仅显示术语名称。
- 名称和计数:显示名称以及该术语中的项目数量。
如何自定义外观
您可以通过多种方式自定义“术语查询”区块,部分原因是它由可重新排列、添加等操作的嵌套区块组成。当您自定义“术语查询”区块中的一个区块时,更改将应用于所有相同类型的区块。自定义此区块时,使用顶部工具栏中的列表视图可能会有所帮助。以下是一些可供您参考的自定义思路:
- 您可以更改“术语查询”区块各个部分的宽度。
- 您可以更改“术语查询”区块中区块的对齐方式。
- 您可以根据自己的喜好重新排列区块,通过拖放或使用移动控件来完成。
- 您可以通过选择“术语查询”区块并在区块设置中调整“最大术语数”选项,来更改所列出的术语数量。
- 您可以为嵌套区块设置各种颜色选项。
- 您可以通过选择“术语数量”区块并在区块工具栏中更改格式,来更改术语数量的显示方式。
- 您可以通过选择“术语描述”区块并根据需要调整样式,来显示术语描述。
区块工具栏
要查看区块工具栏,请点击区块,工具栏就会显示出来。每个区块都有独特的工具栏图标和区块专用的用户控件,让您可以直接在编辑器中操作区块。“术语查询”区块包含以下选项:
- 转换为。
- 对齐方式:无、宽幅、全宽。
- 移动/拖动以在模板中重新定位。
- 更多选项(复制、锁定、移除等)。
转换为
点击“转换”按钮,将“查询循环”区块转换为“组”或“列”区块。

拖动图标
要将区块拖放到新位置,请点击并按住点状矩形,然后将其拖到新位置。蓝色分隔线表示区块将放置的位置。找到新位置后,松开鼠标左键即可放置区块。

移动箭头
向上和向下箭头图标可用于在页面上向上或向下移动区块。

有关在编辑器中移动区块的详细说明,请参阅此处
对齐
使用更改对齐工具来对齐“术语循环”区块。请选择以下选项之一:
- 无 – 保留区块当前大小。
- 宽幅 – 将区块宽度增加到超出内容宽度。
- 全宽 – 将区块扩展到覆盖屏幕的全部宽度。
“宽幅”和“全宽”对齐设置必须由您的 WordPress 主题启用。

列表视图(默认)
以堆叠列表形式显示术语。选择“术语模板”区块进行编辑。

网格视图
以网格视图显示术语。选择“术语模板”区块进行编辑。

选项
区块工具栏上的“选项”按钮提供了更多用于自定义区块的功能。
区块设置
内部区块使用内容宽度
此选项允许您为“查询循环”区块中的所有嵌套区块配置对齐方式、内容宽度和宽幅设置。
排序依据
- 名称:A > Z
- 名称:Z > A
- 计数:从高到低
- 计数:从低到高
已选术语
此选项允许您选择要显示的特定分类法。只需搜索并选择要添加的内容即可。
显示空术语
此选项允许您显示空术语,即使它们没有内容。此选项默认关闭。
显示嵌套术语
此选项允许您显示嵌套术语。此选项默认关闭。
最大术语数
此选项允许您限制要显示的术语数量。要显示所有术语,请使用 0(零)。
高级设置
“高级”选项卡允许您向区块添加 CSS 类,以便编写自定义 CSS 并按照您的意愿设置区块样式。它还允许您指定 HTML 元素。
演示
提示
- 层级分类法使用列表;需要快速浏览大量术语时使用网格。
- 突出显示术语名称;在落地页上添加术语描述以提供上下文。
- 使用“隐藏空术语”来避免空白归档,并保持列表的相关性。
- 将配置好的“术语查询”部分保存为区块样板,以便在不同模板中重复使用。
常见问题
我可以只显示顶级术语吗?
- 可以。将“父级”留空,并关闭“包含子术语”。
我可以显示自定义分类法吗?
- 可以,只要它是公开的,并且注册为可在编辑器中显示(show_in_rest 为 true)。
我可以将术语名称链接到其归档页面吗?
- 术语名称通常默认链接到术语归档页面。您可以在其区块设置中控制其他链接(例如术语计数)。
变更日志
- 创建于 2025-12-02