WordPress 6.2自定义区块主题alignwide/alignfull按钮不显示求助

可能原因 #

1. theme.json配置层级错误：你将layout配置放在了根节点，而非settings节点下，导致编辑器无法识别宽/全宽布局的设置。
2. 冗余代码冲突：区块主题无需在functions.php中添加add_theme_support( 'align-wide' )，该代码为经典主题设计，会干扰区块主题的编辑器配置识别。
3. 区块对齐权限未开启：组、封面等部分区块的宽/全宽对齐选项默认未启用，需要在theme.json中明确开启。
4. 缓存干扰：浏览器或站点缓存导致编辑器未加载最新的theme.json配置。

解决方法 #

1. 修正theme.json的layout配置层级 #

确保layout设置位于settings节点下，正确配置结构如下：

{
  "$schema": "https://schemas.wp.org/trunk/theme.json",
  "version": 2,
  "settings": {
    "layout": {
      "contentSize": "860px",
      "wideSize": "1100px"
    }
  },
  "styles": {
    // 你的其他样式配置
  }
}

注意：必须指定"version": 2，WordPress 6.2依赖该版本的theme.json规范。

2. 删除functions.php中的冗余代码 #

移除add_theme_support( 'align-wide' );这一行代码，避免与区块主题的theme.json配置冲突。

3. 启用目标区块的对齐选项 #

在theme.json的settings.blocks中，为需要的区块开启宽/全宽对齐支持。示例：

"settings": {
  // 已有的layout配置
  "blocks": {
    "core/group": {
      "align": ["wide", "full"]
    },
    "core/cover": {
      "align": ["wide", "full"]
    }
  }
}

如果需要全局开启所有区块的对齐支持，也可以直接在settings下添加：

"settings": {
  "align": true,
  // 其他配置
}

4. 清除缓存 #

• 用快捷键Ctrl+Shift+R（Windows）或Cmd+Shift+R（Mac）强制刷新浏览器，清除浏览器缓存
• 禁用或清除站点缓存插件的缓存
• 重新登录WordPress后台，刷新编辑器页面

内容的提问来源于stack exchange，提问作者Ron