TYPO3 8中Linkhandler配置自定义data属性不生效问题咨询

解决方案 #

1. 修正TypoScript配置写法 #

你当前配置里ATagParams的双引号用了HTML实体"，属于语法错误，TypoScript中不需要做HTML实体转义，直接写原生属性即可，修正后的配置如下：

config.recordLinks.test {
  forceLink = 0
  typolink {
    parameter = #test
    ATagParams = data-toggle="hover"
  }
}

2. 配置HTML净化器允许自定义属性 #

如果你使用的是TYPO3 v10及以上版本，默认开启的HTML净化器会自动过滤不在白名单内的标签属性，你需要额外将data-toggle属性加入a标签的允许属性列表：

# 针对RTE解析场景添加允许属性
lib.parseFunc_RTE.htmlSanitize.default.allowedTags.a.attributes := addToList(data-toggle)
# 如果涉及非RTE的自定义渲染场景，对应添加对应parseFunc的白名单配置即可

3. 缓存与配置覆盖排查 #

• 修改完TypoScript后清空全站系统缓存，避免旧配置缓存导致不生效
• 进入后台「模板」模块的TypoScript对象浏览器，搜索config.recordLinks.test确认最终生效的配置是否符合预期，排查是否存在其他配置覆盖了你的设置。

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