Django中如何将url标签生成的路径传递给include标签

Django 模板语法不支持在模板标签参数内嵌套其他模板标签，你写的{% include ... url={% url 'xxx' %} %}属于非法语法，以下是3种可落地的实现方案，按改造成本从低到高排序：

方案1：用as关键字先把URL存为模板变量（零后端代码，最推荐） #

Django 内置的url标签原生支持as参数，可以先把反向解析得到的URL赋值给临时变量，再传给include标签，完全兼容你现有的组件代码，不需要改任何Python逻辑：

{# in base.html #}
{% url 'event_manager:index' as event_manager_index_url %}
{% include 'components/navbar/nav-item.html' with title='Event Manager' url=event_manager_index_url %}

你原来的nav-item.html组件不需要做任何修改即可正常工作。

方案2：自定义包含模板标签（适合导航栏这类高频复用组件） #

如果导航项数量多，每次先赋值变量写起来冗余，可以自定义专用的导航项模板标签，直接在标签内部处理URL反向解析，不需要手动嵌套模板标签：

1. 在对应app下创建templatetags/navbar_tags.py文件
2. 写入以下注册标签的代码：

from django import template
from django.urls import reverse, NoReverseMatch

register = template.Library()

@register.inclusion_tag('components/navbar/nav-item.html')
def nav_item(title, url_name=None, url=None):
    # 优先使用直接传入的固定URL，其次传入路由别名做反向解析
    if url_name:
        try:
            url = reverse(url_name)
        except NoReverseMatch:
            url = '#'
    return {'title': title, 'url': url}

3. 在模板顶部加载自定义标签后即可直接调用，不需要额外处理URL：

{% load navbar_tags %}
{# 直接传路由别名即可自动解析 #}
{% nav_item title='Event Manager' url_name='event_manager:index' %}
{# 也兼容原来直接传固定URL的场景 #}
{% nav_item title='Static Page' url='/about/' %}

方案3：全局上下文处理器（适合全站固定导航链接，无需每个视图传参） #

如果不想在每个模板里重复写导航项的传参逻辑，可以写自定义上下文处理器，把导航链接列表全局注入所有模板的上下文，完全不需要在每个视图里重复传值：

1. 新建your_app/context_processors.py文件：

from django.urls import reverse

def global_navbar(request):
    return {
        'navbar_list': [
            {'title': '首页', 'url': reverse('index')},
            {'title': '活动管理', 'url': reverse('event_manager:index')},
            # 所有导航项统一在这里维护即可
        ]
    }

2. 打开项目settings.py，找到TEMPLATES配置下的OPTIONS.context_processors列表，把你写的上下文处理器加进去：

TEMPLATES = [
    {
        # 其他原有配置保持不变
        'OPTIONS': {
            'context_processors': [
                # 保留默认的上下文处理器
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
                # 新增自定义的导航上下文处理器
                'your_app.context_processors.global_navbar',
            ],
        },
    },
]

3. 之后直接在base.html里循环渲染导航即可，不需要每次单独传参：

<ul class="navbar">
{% for nav in navbar_list %}
    {% include 'components/navbar/nav-item.html' with title=nav.title url=nav.url %}
{% endfor %}
</ul>

后续新增、调整导航项只需要修改上下文处理器里的列表即可，不需要改动模板和视图代码。

注意：不要在上下文处理器里写复杂的数据库查询逻辑，避免给所有请求增加不必要的性能开销，固定导航链接用这个方案最合适。

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