You need to enable JavaScript to run this app. Drupal Twig嵌套调用attributes.addClass导致类名串叠问题求助
优惠活动
大模型
产品
解决方案
定价
更多

Drupal Twig嵌套调用attributes.addClass导致类名串叠问题求助

Drupal Twig 类名跨节点叠加问题修复

问题核心原因

Drupal 传递到 Twig 模板上下文的attributes是全局共享的可变对象实例。addClass()方法会直接在当前对象的类名集合中追加值,不会自动识别DOM节点边界做拆分。在模板内外两个div上调用的attributes.addClass()本质上操作的是同一个实例,所以所有追加的类名都会被合并到同一个集合中,最终被两个节点同时引用,出现类名叠加。

具体修复方案

  • 不要直接在不同DOM节点上复用全局共享的attributes对象,使用Drupal Twig内置的create_attribute()函数为每个需要独立绑定类名的节点创建独立的Attributes实例,不同实例之间的类名、属性完全隔离。
  • 按照独立绑定的逻辑调整模板代码:
    1. 常见的错误写法(会触发类名叠加):
    {% 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>
    
    1. 调整后的正确写法(实现类名独立绑定):
    {% 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 11:54:01