查询循环区块

返回区块列表

查询循环块是一个高级块，允许您根据指定参数显示文章，就像一个无需代码的 PHP 循环。您可以将其视为一个更复杂、更强大的最新文章块。通过将各种块模式集成到块设置中，您可以创建作品集或一个包含您最喜爱食谱的页面。

查询循环块的结构

块检查器提供了查询循环块结构的快速概览。每个部分都允许您访问不同的设置

• 查询循环：配置查询参数，例如文章类型或分类。
• 文章模板：选择内容的显示方式，可以是列表或网格格式。
• 分页：选择要包含的导航元素，例如下一页/上一页按钮或页码。
• 无结果：设置当查询没有返回结果时要显示的消息。

添加查询循环块

要将查询循环块添加到页面，请点击块插入器（+）图标以打开块插入器弹出窗口，然后选择查询循环块。

您也可以使用键盘快捷键/query-loop快速插入查询循环块。

添加区块的详细说明

块配置

添加查询循环块后，您将看到两个选项

• 选择
• 从空白开始

如何选择模式

如果您选择“选择”选项，您将有各种模式选项。只需选择一个您喜欢的，它就会被添加。每个查询循环块都由各种嵌套块组成，例如文章标题块和分页块，因此根据您选择的模式，嵌套块可能会有所不同。

如何从空白开始

如果您选择“从空白开始”选项，您会看到四种可供选择的变体。选择您想要使用的一个。

如何自定义外观

自定义查询循环块的方法有很多，部分原因是它由可以重新排列、添加等的嵌套块组成。当您自定义查询循环块中的一个块时，更改将应用于所有相同类型的块。在自定义此块时，使用顶部工具栏中的列表视图可能会有所帮助。以下是一些自定义的想法，供您参考

• 您可以更改查询循环块各个方面的宽度。
• 您可以更改查询循环块内块的对齐方式。
• 您可以在查询循环块中添加块，例如文章作者或文章摘要。
• 您可以根据喜好重新排列块，通过拖放或使用移动器来完成。
• 您可以通过选择查询循环块并在块工具栏中调整“显示设置”选项来更改列出的文章数量。
• 您可以为嵌套块设置各种颜色选项。
• 您可以通过添加特色图像块来添加特色图像。

当查询循环块没有返回结果时，也可以添加文本或块

区块工具栏

要查看块工具栏，请点击该块，工具栏就会显示出来。

每个块都有独特的工具栏图标和块特定的用户控件，允许您直接在编辑器中操作该块。

查询循环块在块工具栏中显示九个按钮

• 转换为
• 拖动图标
• 移动箭头
• 对齐
• 显示设置
• 替换
• 列表视图/网格视图
• 更多选项

转换为

点击“转换”按钮，将查询循环块转换为“组”或“列”块。

拖动图标

要将块拖放到页面模板上的新位置，请点击并按住点状矩形，然后将其拖到新位置。蓝色分隔线指示块将放置的位置。找到放置块的新位置后，释放鼠标左键。

移动箭头

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

有关在编辑器中移动块的详细说明可在此处找到

对齐

使用更改对齐工具来对齐查询循环块。选择以下选项之一

• 无 – 保持块的当前大小。
• 宽幅 – 将块的宽度增加到超出内容大小。
• 全宽 – 将块扩展到覆盖屏幕的整个宽度。

“宽幅”和“全宽”对齐设置必须由您的 WordPress 主题启用。

显示设置

使用显示设置工具更改查询循环块的各种选项。选择以下选项之一

• 每页项目数 – 选择您想在查询循环块中显示多少文章。
• 偏移 – 启用查询循环块以跳过一定数量的 WordPress 文章再开始输出。
• 要显示的最大页面数 – 限制显示多少内容。

如果您没有看到此部分，那是因为您需要关闭“从模板继承查询”设置。

替换

使用替换选项，用新模式替换当前模式。

列表视图（默认）

以堆叠列表形式显示您的文章。

网格视图

以网格视图形式显示您的文章。

选项

块工具栏上的“选项”按钮为您提供了更多自定义块的功能。

阅读有关这些及其他设置的信息。

区块设置

块设置面板包含特定于块的自定义选项。要打开它，请选择块并点击“发布/更新”按钮旁边的设置图标。

以下是查询循环块的选项

颜色

从 WordPress 6.2 开始，查询循环块将不再支持颜色设置。因此，您需要更改查询循环块内各个块的颜色

有关更改颜色的更多信息，请参阅本指南。

内部块使用内容宽度

此选项允许您配置查询循环块内的所有嵌套块的对齐方式、内容和宽幅设置。

从模板继承查询

这是一个可以打开和关闭的选项，取决于您是否要自定义循环所依赖的查询。否则，WordPress 将依赖所使用的模板来确定显示哪些文章。如果您将其打开，某些自定义选项将隐藏。如果您将其关闭，则会显示更多自定义选项。

文章类型

WordPress 包含不同类型的内容，它们被划分为称为“文章类型”的集合。默认情况下，有几种不同的类型，例如博客文章和页面，但插件可以添加更多。

排序方式

• 最新到最旧（默认）
• 最旧到最新
• 按字母顺序 A 到 Z
• 按字母顺序 Z 到 A
• 按升序
• 按降序

置顶文章

此选项允许您在三个选项之间进行选择

• 包含（默认）– 显示置顶文章。
• 排除 – 移除置顶文章。
• 忽略 – 忽略置顶文章。
• 仅限 – 仅显示置顶文章。

滤镜

此选项允许您进一步自定义显示哪些文章。如果您没有看到此部分，那是因为您需要关闭“从模板继承查询”设置。

• 分类 – 列出您希望包含的任何分类。
• 标签 – 列出您希望包含的任何标签。
• 作者 – 搜索作者并将其添加到列表中，允许添加多位作者。
• 关键词 – 输入您希望包含的任何关键词。

请注意，自定义分类法过滤也是可能的。请查看以下 WooCommerce 产品分类过滤器的示例

如果您选择分层文章类型（如“页面”），将显示这些选项

• 作者 – 搜索作者并将其添加到列表中，允许添加多位作者。
• 关键词 – 输入您希望包含的任何关键词。
• 父级 – 列出您希望包含的任何父级。

高级设置

高级选项卡允许您为块添加 CSS 类，从而可以编写自定义 CSS 并根据需要样式化该块。它还允许您分配 HTML 元素。

资源

• 查询循环：WordPress 5.8 最强大功能之一的来龙去脉