在Django内置模板标签中使用自定义Simple Tag报错问题咨询

问题根源 #

你遇到的报错和Django内置模板标签限制无关，问题出在两个细节上：

1. 自定义Tag参数不匹配：你给Tag设置了takes_context=True，但函数签名里没有接收context参数。当开启takes_context=True时，Django会自动把模板上下文作为第一个参数传给Tag函数，函数未接收该参数会直接触发参数不匹配错误。
2. 模板变量赋值错误：你直接输出Tag返回值后，试图用{{billamount}}调用结果，但Simple Tag默认只会直接输出内容，不会自动把结果绑定到这个变量上。

修复步骤 #

1. 修正自定义Tag的定义

如果你的Tag不需要使用模板上下文，直接去掉takes_context=True即可：

from django import template

register = template.Library()

@register.simple_tag(name="calculate_billamount")
def calculate_billamount(quantity, unitprice):    
    return quantity * unitprice

如果确实需要用到上下文（比如获取request对象），必须在函数第一个参数位置加上context：

@register.simple_tag(takes_context=True, name="calculate_billamount")
def calculate_billamount(context, quantity, unitprice):    
    # 可在此使用context，例如 context['request']
    return quantity * unitprice

2. 修正模板中的使用方式

如果要把Tag计算结果存到billamount变量中，需要用as关键字赋值，同时建议使用循环内的order_detail字段（而非硬编码数值）：

{% for order_detail in order_details %}
    {% if order_detail.orderid == order %}    
        <tr>
            <td>{{ order_detail.productid.productname }}</td>
            <td>{{ order_detail.unitprice }}</td>
            <td>{{ order_detail.quantity }}</td>   
            {% calculate_billamount quantity=order_detail.quantity unitprice=order_detail.unitprice as billamount %}
            <td>{{ billamount }}</td>
        </tr>
    {% endif %}               
{% endfor %}

如果不需要存储变量，直接输出计算结果也可以：

<td>{% calculate_billamount quantity=order_detail.quantity unitprice=order_detail.unitprice %}</td>

总结 #

Django完全允许在for/if等内置标签内部使用自定义Simple Tag，没有特殊限制。你的问题是Tag定义和模板使用的语法错误导致的，按上述步骤修正即可解决。

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