如何在Django模板中无需临时变量遍历simple_tag返回的字典？

问题原因 #

Django的simple_tag默认会把返回值直接渲染输出，而非作为可操作的Python对象留在模板上下文里。你直接写get_types.values时，模板实际是把tag输出的字典字符串（比如{'item1': 'Foo', 'item2': 'Bar'}）当成对象去访问values属性，自然取不到有效内容，所以循环没有输出。

解决方案 #

截至Django 5.x版本，simple_tag的核心机制没变化，要避开临时变量可以用以下两种方法：

方法一：改用模板过滤器（Filter）

过滤器支持返回Python对象并链式调用，调整标签定义：

from django import template

register = template.Library()

@register.filter
def get_types(_):
    # 占位参数满足过滤器至少需要一个输入的要求
    return {
        "item1": "Foo",
        "item2": "Bar",
    }

模板中这样写：

{% for type in ''|get_types.values %}
    <th>{{ type }}</th>
{% endfor %}

用空字符串作为过滤器的输入参数，调用get_types返回字典后直接访问values属性循环。

方法二：直接返回可迭代的values集合

如果只需要遍历字典的values，直接修改simple_tag返回values集合：

from django import template

register = template.Library()

@register.simple_tag
def get_type_values():
    types = {
        "item1": "Foo",
        "item2": "Bar",
    }
    return types.values()

模板里直接循环：

{% for type in get_type_values %}
    <th>{{ type }}</th>
{% endfor %}

这种方式更直接，不需要在模板里处理字典属性访问。

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