You need to enable JavaScript to run this app. Freemarker菜单子页场景下Map<String,List<String>>结构迭代实现
优惠活动
大模型
产品
解决方案
定价
更多

Freemarker菜单子页场景下Map<String,List<String>>结构迭代实现

Freemarker 中 Map<String, List> 嵌套结构迭代实现

这类结构是菜单渲染、分组子页面开发中的常见数据格式,迭代逻辑为两层嵌套遍历:先逐行读取Map的键值对分组,再遍历每个分组下的字符串列表即可完成渲染。

通用实现写法

假设你存储目标数据集的变量名为groupedData,对应示例结构为{ "keyval1": ["sbcd1", "sbcd2", "sbcd3", "sbcd4", "sbcd5"] },直接用两层#list嵌套即可完成遍历:

<!-- 先判断整个Map非空,避免空值报错 -->
<#if groupedData?? && !groupedData?isEmpty()>
  <!-- 第一层遍历:直接解构拿到Map的分组键、对应值列表 -->
  <#list groupedData as groupKey, groupItems>
    <div class="menu-group">
      <h3>${groupKey}</h3>
      <!-- 先判断当前分组的列表非空,渲染子项 -->
      <#if groupItems?? && !groupItems?isEmpty()>
        <ul class="sub-page-list">
          <!-- 第二层遍历:逐个输出列表内的字符串元素 -->
          <#list groupItems as subItem>
            <li>${subItem}</li>
          </#list>
        </ul>
      </#if>
    </div>
  </#list>
</#if>

低版本Freemarker兼容写法

如果使用的Freemarker版本不支持as 键, 值的解构语法,可以通过遍历Map键、手动取值的方式实现,适配所有版本:

<#if groupedData?? && !groupedData?isEmpty()>
  <!-- 先拿到Map的所有键组成的列表 -->
  <#list groupedData?keys as groupKey>
    <!-- 通过键从Map中取出对应的子列表 -->
    <#assign groupItems = groupedData[groupKey]>
    <div class="menu-group">
      <h3>${groupKey}</h3>
      <#if groupItems?? && !groupItems?isEmpty()>
        <ul class="sub-page-list">
          <#list groupItems as subItem>
            <li>${subItem}</li>
          </#list>
        </ul>
      </#if>
    </div>
  </#list>
</#if>

开发中常用增强能力

  • 列表下标获取:遍历列表时可以通过内置的item_index变量拿到当前元素从0开始的下标,用于做隔行换色、选中态判断等逻辑,例如:
    <li class="${subItem_index == 0 ? 'active' : ''}">${subItem}</li>
  • 类型校验:如果上游数据存在结构不稳定的情况,可以用groupItems?is_sequence判断当前值是否为可遍历的序列结构,避免因为数据格式问题抛出渲染异常。

内容的提问来源于stack exchange,提问作者Vishnu K

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.13 08:06:04