如何在AEM中遍历嵌套Multifield的二级内容？

核心问题分析 #

本质是嵌套Multifield的资源结构未被Sling模型正确映射，导致HTL无法遍历二级数据。需要确保Dialog配置、Sling模型嵌套映射、HTL遍历逻辑三者完全匹配。

第一步：确认Dialog配置的正确性 #

嵌套Multifield必须设置composite="{Boolean}true"，否则二级数据会平铺在一级节点下，无法被识别为独立子资源。以下是标准的嵌套结构示例：

<!-- _cq_dialog/.content.xml 核心片段 -->
<contentGroup
    jcr:primaryType="nt:unstructured"
    sling:resourceType="granite/ui/components/coral/foundation/form/multifield"
    composite="{Boolean}true"
    fieldLabel="容器组">
    <field
        jcr:primaryType="nt:unstructured"
        sling:resourceType="granite/ui/components/coral/foundation/container">
        <items jcr:primaryType="nt:unstructured">
            <!-- 容器自身字段 -->
            <containerTitle
                jcr:primaryType="nt:unstructured"
                sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                fieldLabel="容器标题"
                name="./containerTitle"/>
            <!-- 二级Multifield：信息卡片 -->
            <contentData
                jcr:primaryType="nt:unstructured"
                sling:resourceType="granite/ui/components/coral/foundation/form/multifield"
                composite="{Boolean}true"
                fieldLabel="信息卡片">
                <field
                    jcr:primaryType="nt:unstructured"
                    sling:resourceType="granite/ui/components/coral/foundation/container">
                    <items jcr:primaryType="nt:unstructured">
                        <cardTitle
                            jcr:primaryType="nt:unstructured"
                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                            fieldLabel="卡片标题"
                            name="./cardTitle"/>
                        <cardDesc
                            jcr:primaryType="nt:unstructured"
                            sling:resourceType="granite/ui/components/coral/foundation/form/textfield"
                            fieldLabel="卡片描述"
                            name="./cardDesc"/>
                    </items>
                </field>
            </contentData>
        </items>
    </field>
</contentGroup>

第二步：编写嵌套Sling模型 #

需要创建三级模型：主组件模型、一级容器模型、二级卡片模型，通过@ChildResource映射嵌套资源。

1. 二级卡片模型（InfoCard.java）

映射单张信息卡片的字段：

package com.yourproject.models;

import org.apache.sling.api.resource.Resource;
import org.apache.sling.models.annotations.Model;
import org.apache.sling.models.annotations.injectorspecific.ValueMapValue;

@Model(adaptables = Resource.class)
public class InfoCard {
    @ValueMapValue
    private String cardTitle;

    @ValueMapValue
    private String cardDesc;

    // Getters
    public String getCardTitle() { return cardTitle; }
    public String getCardDesc() { return cardDesc; }
}

2. 一级容器模型（ContainerGroup.java）

映射单个容器及其内部的卡片列表：

package com.yourproject.models;

import org.apache.sling.api.resource.Resource;
import org.apache.sling.models.annotations.Model;
import org.apache.sling.models.annotations.injectorspecific.ChildResource;
import org.apache.sling.models.annotations.injectorspecific.ValueMapValue;

import java.util.List;

@Model(adaptables = Resource.class)
public class ContainerGroup {
    @ValueMapValue
    private String containerTitle;

    // 名称需与Dialog中二级Multifield的name完全匹配（去掉前缀./）
    @ChildResource
    private List<InfoCard> contentData;

    // Getters
    public String getContainerTitle() { return containerTitle; }
    public List<InfoCard> getContentData() { return contentData; }
}

3. 主组件模型（ContainerCardComponentModel.java）

映射所有容器组：

package com.yourproject.models;

import org.apache.sling.api.resource.Resource;
import org.apache.sling.models.annotations.DefaultInjectionStrategy;
import org.apache.sling.models.annotations.Model;
import org.apache.sling.models.annotations.injectorspecific.ChildResource;

import java.util.List;

@Model(
    adaptables = Resource.class,
    resourceType = "yourproject/components/content/container-card-component", // 需与组件resourceType完全一致
    defaultInjectionStrategy = DefaultInjectionStrategy.OPTIONAL
)
public class ContainerCardComponentModel {
    // 名称需与Dialog中一级Multifield的name完全匹配（去掉前缀./）
    @ChildResource
    private List<ContainerGroup> contentGroup;

    public List<ContainerGroup> getContentGroup() { return contentGroup; }
}

第三步：HTL遍历渲染 #

通过双层data-sly-list实现嵌套遍历：

<!-- container-card-component.html -->
<sly data-sly-use.model="com.yourproject.models.ContainerCardComponentModel">
    <div class="container-card-wrapper">
        <!-- 遍历一级容器组 -->
        <sly data-sly-list.container="${model.contentGroup}">
            <div class="container-group">
                <h3 class="container-title">${container.containerTitle}</h3>
                <!-- 遍历当前容器下的信息卡片 -->
                <div class="card-grid">
                    <sly data-sly-list.card="${container.contentData}">
                        <div class="info-card">
                            <h4>${card.cardTitle}</h4>
                            <p>${card.cardDesc}</p>
                        </div>
                    </sly>
                </div>
            </div>
        </sly>
    </div>
</sly>

常见排查要点 #

1. Composite属性缺失：嵌套Multifield必须设置composite=true，否则无法生成独立子资源节点。
2. 模型名称匹配：@ChildResource的名称必须与Dialog中Multifield的name（去掉./前缀）完全一致。
3. ResourceType匹配：主模型的resourceType必须与组件的resourceType完全相同，否则模型无法被适配。
4. 依赖检查：确保项目pom.xml中已引入Sling Models API依赖（AEM 6.5+默认包含，但需确认版本）。

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