
在 django 模板中无法直接使用变量作为索引(如 `activity_list.week.number.0`)访问多维列表,需通过自定义模板过滤器实现动态索引访问。
要在 Django 模板中根据 Plan 模型中的 week.number(假设你已在视图中为每周生成了带序号的 week 对象,例如通过 enumerate() 或自定义 Week 数据类)动态访问 activity_list[i][j],核心难点在于:Django 模板语言不支持变量索引语法(如 list.{{ i }}.{{ j }}),且点号(.)访问符仅支持字典键或属性名的静态解析,不会对中间变量求值。
✅ 正确解法是编写一个轻量级自定义模板过滤器,用于安全地执行索引操作:
1. 创建自定义过滤器(推荐放在 templatetags/list_extras.py):
# myapp/templatetags/list_extras.py
from django import template
register = template.Library()
@register.filter
def get_item(container, key):
"""
安全获取容器中指定键/索引的值。
支持 list[int], tuple[int], dict[key], 以及链式调用(配合多次 |get_item)
"""
try:
return container[key]
except (KeyError, TypeError, IndexError, ValueError):
return None⚠️ 注意:确保已将该应用添加到 INSTALLED_APPS,并在模板顶部加载标签:{% load list_extras %}
2. 在模板中使用(假设 activity_list 是二维列表,week.number 是当前周索引):
{% load list_extras %}
{% for week in plan.weeks_with_numbers %} {# 如 [[0, 'Week 1'], [1, 'Week 2']] #}
Week {{ week.1 }}
{% with day0=activity_list|get_item:week.0|get_item:0 %}
{% if day0 %}
Monday activity: {{ day0.name }} ({{ day0.distance }} km)
{% else %}
No activity on Monday
{% endif %}
{% endwith %}
{% with wednesday=activity_list|get_item:week.0|get_item:2 %}
Wednesday: {{ wednesday|default:"— " }}
{% endwith %}
{% endfor %}? 关键说明:
- activity_list|get_item:week.0 先取第 i 周的子列表;
- 再对其结果 |get_item:0 取该周第 0 天(周一)的活动对象;
- 过滤器链式调用天然支持嵌套结构,语义清晰、无副作用;
- 异常捕获确保模板渲染健壮,避免因越界或空值导致 500 错误。
? 进阶建议(可选重构):
若频繁进行此类操作,更优雅的方式是在视图层预处理数据,将 activity_list 转换为与 Plan 语义对齐的结构:
# views.py
context['plan_schedule'] = [
{
'week_number': i,
'days': activities_for_week # 即 activity_list[i]
}
for i in range(plan.weeks)
]然后模板中可直接使用 schedule.days.0 —— 但此方式牺牲了灵活性。对于 API 动态数据,自定义过滤器仍是最简洁、复用性最强的标准实践。
总结:不要尝试用 . 拼接变量索引,而应拥抱 Django 的过滤器机制——它专为这类模板逻辑扩展而设计,安全、清晰、符合框架哲学。










