TYPO3 12中CKEditor5的htmlSupport.allow/disallow配置无效求助

核心问题定位 #

你之前配置失效的主要原因是TYPO3对CKEditor5的配置有特定层级要求，原生CKEditor5的htmlSupport必须嵌套在RTE.default.editor.config节点下，同时需要开启allowByDefault = false来启用严格白名单模式。

完整配置示例（Page TSconfig） #

RTE {
  default {
    editor {
      config {
        htmlSupport {
          // 开启严格白名单：仅保留allow中定义的标签
          allowByDefault = false
          // 白名单规则：允许的标签及可附加的属性/类
          allow = [
            {
              name = 'p',
              attributes = {
                class = true, // 允许所有class
                style = /^text-align:(left|center|right);$/ // 仅允许对齐样式
              }
            },
            { name = 'strong' },
            { name = 'em' },
            {
              name = 'table',
              attributes = {
                class = /^table-.*/ // 仅允许以table-开头的类
              }
            },
            { name = 'tr' },
            {
              name = 'td',
              attributes = {
                colspan = true,
                rowspan = true
              }
            }
          ]
          // 黑名单规则：强制移除的标签
          disallow = [
            { name = 'span' },
            { name = 'div' },
            { name = 'font' },
            { name = 'strike' },
            { name = 'u' }
          ]
        }
        // 强化Word粘贴内容过滤
        pasteFromOffice {
          cleanupSemanticElements = true
          removeStyles = true
          removeFontStyles = true
        }
      }
    }
  }
}

关键配置说明 #

• allowByDefault = false：必须开启，否则CKEditor会默认允许大部分标签，白名单规则不生效。
• 正则匹配属性/类：如果需要限制特定类或样式，用正则表达式替代true，比如只允许特定对齐样式、特定前缀的类名。
• pasteFromOffice配合：针对Word粘贴的冗余标签做二次清理，避免漏网之鱼。
• 缓存清理：配置完成后必须清空TYPO3的页面缓存和RTE缓存，否则配置不会生效。

测试验证 #

1. 清空TYPO3后台缓存（顶部工具栏的缓存图标）
2. 新建或编辑内容，从Word复制带冗余标签的表格/文本粘贴到CKEditor5
3. 切换到源码视图（点击工具栏的</>图标），检查是否只有白名单内的标签保留，黑名单标签已被移除

内容的提问来源于stack exchange，提问作者Magic Hat of TYPO3