灯箱

settings.lightbox 是一个特定设置，您可以为支持的块启用它。它会启用灯箱功能，当网站访客点击图片时，该图片会展开。

此设置仅在 WordPress 6.4 中可用，并且专门针对核心图像块 (core/image)。

灯箱设置

lightbox 设置专门用于图像块，因此以下示例将在该上下文中显示。

lightbox 属性是一个对象，具有两个嵌套属性，您可以对其进行配置：

• enabled: 是否启用图像块的灯箱功能。默认值为 undefined（相当于禁用）。
• allowEditing: 是否在界面中显示点击展开选项，允许用户为单个图像启用/禁用灯箱。默认为 true。

以下是默认 theme.json 的概览：

{
	"version": 2,
	"settings": {
		"blocks": {
			"core/image": {
				"lightbox": {
					"allowEditing": true
				}
			}
		}
	}
}

为图像启用灯箱

要为整个网站使用的图像块启用灯箱功能，您必须在 theme.json 中将 settings.blocks.core/image.lightbox.enabled 设置为 true：

{
	"version": 2,
	"settings": {
		"blocks": {
			"core/image": {
				"lightbox": {
					"enabled": true
				}
			}
		}
	}
}

在网站的前端，访客点击图片时可以展开图片。然后图片将覆盖整个屏幕（包括用于关闭覆盖层的x 按钮），如下所示：

禁用用户编辑

默认情况下，WordPress 将在图像块的设置选项卡下显示点击展开选项：

此控件允许您的主题用户按块启用或禁用灯箱功能。

若要禁止用户编辑，您必须在 theme.json 中将 settings.blocks.core/image.lightbox.allowEditing 设置为 false：

{
	"version": 2,
	"settings": {
		"blocks": {
			"core/image": {
				"lightbox": {
					"allowEditing": false
				}
			}
		}
	}
}