Drupal Twig嵌套调用attributes.addClass导致类名串叠问题求助
Drupal Twig 类名跨节点叠加问题修复
问题核心原因
Drupal 传递到 Twig 模板上下文的attributes是全局共享的可变对象实例。addClass()方法会直接在当前对象的类名集合中追加值,不会自动识别DOM节点边界做拆分。在模板内外两个div上调用的attributes.addClass()本质上操作的是同一个实例,所以所有追加的类名都会被合并到同一个集合中,最终被两个节点同时引用,出现类名叠加。
具体修复方案
- 不要直接在不同DOM节点上复用全局共享的
attributes对象,使用Drupal Twig内置的create_attribute()函数为每个需要独立绑定类名的节点创建独立的Attributes实例,不同实例之间的类名、属性完全隔离。 - 按照独立绑定的逻辑调整模板代码:
- 常见的错误写法(会触发类名叠加):
{% set container_classes = ['paragraph', 'paragraph--type--media-text', 'paragraph--view-mode--default', 'container'] %} {% set image_classes = ['col-12'] %} {# 两个节点直接复用同一个全局attributes对象 #} <div {{ attributes.addClass(container_classes) }}> <div {{ attributes.addClass(image_classes) }}> {# 图片渲染逻辑 #} </div> </div>- 调整后的正确写法(实现类名独立绑定):
{% set container_classes = ['paragraph', 'paragraph--type--media-text', 'paragraph--view-mode--default', 'container'] %} {% set image_classes = ['col-12'] %} {# 外层容器:继承全局attributes的默认属性(如元素ID、data属性、aria标签),再绑定自身的容器类名 #} {% set container_attrs = create_attribute(attributes).addClass(container_classes) %} {# 内层图片区块:创建全新独立的Attributes实例,仅绑定图片区块自身的类名 #} {% set image_attrs = create_attribute().addClass(image_classes) %} <div {{ container_attrs }}> <div {{ image_attrs }}> {# 图片渲染逻辑 #} </div> </div>
避坑补充提示
- 给外层容器创建独立实例时,将原全局
attributes作为参数传入create_attribute(),可以完整保留Drupal核心自动附加的元素属性,不会因为拆分实例丢失默认功能。 - 同一Attributes实例不可跨多个DOM节点重复调用
addClass()方法,避免类名集合被意外污染。 - 如果后续需要为节点追加其他自定义属性,直接在对应独立的Attributes实例上操作即可,不会影响其他节点的绑定结果。
内容的提问来源于stack exchange,提问作者Mark Handy
相关产品推荐
相关产品推荐

