如何用Django HTML模板实现动态行列表格并正确输出数据？

嘿，这个动态表格的问题我之前做项目的时候也踩过坑，咱们来一步步捋清楚怎么解决！

首先直接给你结论：Django模板本身不支持直接用变量作为索引（比如{{ row[forloop.counter0] }}这种写法是无效的），但我们完全可以通过自定义模板过滤器，或者提前在视图层预处理数据的方式来实现你要的效果。

下面给你两种最常用的可行方案：

方案一：用字典格式存储行数据（推荐，可读性更强） #

如果能把每行数据整理成字典（表头作为键，对应值为单元格内容），配合自定义过滤器就能轻松实现动态取值。

步骤1：视图层准备数据 #

比如你可以把查询到的结果转成字典列表：

# views.py
def your_view(request):
    # 假设表头是动态获取的
    headers = ["姓名", "年龄", "城市"]
    # 原始数据（比如从数据库用values_list获取的列表）
    raw_results = [["张三", 25, "北京"], ["李四", 30, "上海"]]
    # 转成字典列表
    results = [dict(zip(headers, row)) for row in raw_results]
    return render(request, "your_template.html", {"headers": headers, "results": results})

步骤2：自定义模板过滤器 #

在你的app目录下创建templatetags文件夹（记得加__init__.py），然后新建custom_filters.py文件：

# templatetags/custom_filters.py
from django import template

register = template.Library()

@register.filter
def get_item(dictionary, key):
    # 根据键从字典中取值，不存在则返回空字符串
    return dictionary.get(key, "")

步骤3：模板中渲染表格 #

在模板开头加载自定义过滤器，然后用两层循环渲染：

{% load custom_filters %}

<table border="1">
  <thead>
    <tr>
      {% for header in headers %}
        <th>{{ header }}</th>
      {% endfor %}
    </tr>
  </thead>
  <tbody>
    {% for row in results %}
      <tr>
        {% for header in headers %}
          <!-- 用自定义过滤器根据动态键取值 -->
          <td>{{ row|get_item:header }}</td>
        {% endfor %}
      </tr>
    {% endfor %}
  </tbody>
</table>

方案二：直接用列表格式（适合原始数据就是列表的场景） #

如果你的行数据本身就是列表（比如数据库values_list的结果），我们可以写另一个过滤器来根据索引取值：

步骤1：自定义列表索引过滤器 #

在刚才的custom_filters.py里新增一个过滤器：

@register.filter
def get_list_item(lst, index):
    try:
        # 把索引转成整数，避免格式问题
        return lst[int(index)]
    except (IndexError, ValueError):
        # 索引越界或格式错误时返回空
        return ""

步骤2：模板中渲染表格 #

这时候不需要转字典，直接用列表数据，借助forloop.counter0（从0开始的循环索引）来获取表头对应的列索引：

{% load custom_filters %}

<table border="1">
  <thead>
    <tr>
      {% for header in headers %}
        <th>{{ header }}</th>
      {% endfor %}
    </tr>
  </thead>
  <tbody>
    {% for row in results %}
      <tr>
        {% for header in headers %}
          <!-- 用forloop.counter0拿到当前列的索引，再通过过滤器取值 -->
          <td>{{ row|get_list_item:forloop.counter0 }}</td>
        {% endfor %}
      </tr>
    {% endfor %}
  </tbody>
</table>

额外小提示 #

如果你不想写自定义过滤器，也可以在视图层提前把每个列表行转成普通字典，不过本质上和方案一的思路一致，还是需要用过滤器来动态取键值。

总的来说，Django完全支持这种动态行列表格的需求，核心就是绕开模板不能直接用变量索引的限制，用自定义过滤器或者数据预处理来解决~

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