TYPO3 12.4.7中CKEditor 5 HTML支持配置无效，需如何调整？

云原生阿岚

2026-7-8

TYPO3 12.4.7 RTE CKEditor 允许DIV标签配置失效的解决办法

针对你遇到的DIV标签被转为P标签、属性丢失的问题，可以尝试以下关键配置步骤：

确保RTE预设被正确引用
你的站点包预设MyPreset需要绑定到对应的富文本字段。比如在EXT:my_sitepackage/Configuration/TCA/Overrides/tt_content.php中，为内容字段指定该预设：
```
$GLOBALS['TCA']['tt_content']['columns']['bodytext']['config']['richtextConfiguration'] = 'MyPreset';
```
也可以在系统设置的「RTE配置」中，将默认预设设置为MyPreset。
补充HTML解析器允许规则
TYPO3后端的HTML解析器会过滤未授权的标签和属性，需显式添加允许规则：
在EXT:my_sitepackage/Configuration/TCA/Overrides/tt_content.php中添加：
```
// 允许DIV标签
$GLOBALS['TYPO3_CONF_VARS']['HTMLparser']['allowTags'] .= ',div';
// 允许DIV的class和style属性
$GLOBALS['TYPO3_CONF_VARS']['HTMLparser']['allowAttribs'] .= ',class,style';
```

完善RTE预设的处理规则
在你的MyPreset.yaml中补充processing配置，覆盖默认HTML处理逻辑：

RTE:
  config:
    htmlSupport:
      allow:
        - { name: 'div', attributes: true, classes: true, styles: true }
    processing:
      allowTags:
        - div
      allowAttribs:
        - class
        - style
      allowClasses: true
      allowStyles: true
    editor:
      config:
        extraAllowedContent: 'div(*)[*]{*}'

其中extraAllowedContent用于确保CKEditor编辑器本身允许DIV标签的所有类、属性和样式。