Django inclusion_tag传递HTML参数报错，求优雅实现方案

你遇到的报错是因为Django模板解析器不允许在标签参数里直接写原始HTML语法——模板标签的参数只能是字符串字面量、变量、过滤器表达式这类合法的模板语法元素。要实现传递HTML的需求，有几种简洁且非hack的方式：

1. 传递HTML字符串并在模板中标记为安全 #

步骤1：修改inclusion tag的模板 #

把row_with_cols.html里的{{ col }}改成{{ col|safe }}，让Django不再转义HTML内容：

<tr>
    {% for col in cols %}<td>{{ col|safe }}</td>{% endfor %}
</tr>

步骤2：调用时传递拼接好的HTML字符串 #

用模板过滤器拼接HTML内容，作为参数传给tag：

{% row_with_cols "Image" '<img src="'|add:session.userinfo.picture|add:'">' %}

如果HTML片段更复杂，可先通过{% with %}定义变量再传递：

{% with user_img='<img src="'|add:session.userinfo.picture|add:'" alt="User avatar">' %}
    {% row_with_cols "Image" user_img %}
{% endwith %}

2. 传递视图中预生成的安全HTML变量 #

如果HTML内容是在视图中生成的，可直接把标记为安全的HTML作为上下文变量传给模板，再传递给tag：

视图代码： #

from django.utils.safestring import mark_safe

def your_view(request):
    user_img_html = mark_safe(f'<img src="{request.session["userinfo"]["picture"]}">')
    return render(request, 'your_template.html', {'user_img_html': user_img_html})

模板调用： #

{% row_with_cols "Image" user_img_html %}

这种方式无需修改tag模板，因为mark_safe已标记内容为安全，Django会直接渲染原始HTML。

注意事项 #

• 使用|safe或mark_safe时，要确保传递的HTML内容是可信的，避免未过滤的用户输入引发XSS攻击。
• 保持tag通用性的核心是让它只负责渲染列结构，把内容的安全性交给调用者或视图层处理，无需给tag添加特殊逻辑。

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