theme.json 中的 settings.position 属性可让您控制 WordPress 中块的全局定位设置。请注意,这允许您配置用户界面中可用的设置,而不是位置样式。

位置设置

position 是一个对象,直接嵌套在 theme.json 顶层的 settings 属性中。目前,它仅允许您设置一个属性:

  • sticky: 启用块对Position: Sticky选项支持的布尔值。

查看 theme.json 文件中 position 属性的上下文及其默认值:

{
	"version": 2,
	"settings": {
		"position": {
			"sticky": false
		}
	}
}

启用粘性定位

粘性定位在具有随用户向下滚动页面而粘附到屏幕顶部的标题的主题设计中特别有用。这是主要用例之一,但它也可用于其他场景。

将块设置为粘性位置时,当用户滚动页面时,该块会粘附到其最直接的父级。只有在 theme.json 中启用时才可能进行粘性定位。

要启用支持它的块的粘性定位,请将 settings.position.sticky 设置为 true:

{
	"version": 2,
	"settings": {
		"position": {
			"sticky": true
		}
	}
}

这将启用块检查器控件中的新Position选项卡(对于支持位置功能的块,例如 Group)。该控件将显示一个下拉选择框,其中包含可用的位置选项:Default 和 Sticky:

WordPress 站点编辑器,已选择 Header 模板部分。在右侧边栏中,Position 设置选择了 Sticky 选项。

如果您想创建粘性标题,请注意不能在 Header 模板部分上使用定位。您必须将其包装在一个包含的 Group 块中,并将粘性定位应用于 Group。