Django实现全局导航栏加载模型数据的方法咨询

你遇到的问题很典型——ListView只会在它对应的URL请求时，把object_list注入到模板上下文里，其他视图没有这个变量，所以导航栏在其他页面就没数据了。不用在每个视图里重复写代码，有两种常用的优雅方案：

方案一：自定义上下文处理器（推荐全局数据场景） #

上下文处理器会在所有模板渲染时自动注入指定的上下文变量，非常适合导航栏这种全局需要的数据：

1. 在你的tags应用下新建一个context_processors.py文件，写入以下代码：

from .models import Tag

def tag_list(request):
    # 返回需要全局可用的变量，这里我们把Tag查询集命名为`tags`（避免和ListView的object_list冲突）
    return {
        'tags': Tag.objects.all()
    }

2. 打开项目根目录的settings.py，找到TEMPLATES配置项，在OPTIONS['context_processors']里添加你刚才写的处理器路径：

TEMPLATES = [
    {
        # 其他配置...
        'OPTIONS': {
            'context_processors': [
                # 原有处理器...
                'tags.context_processors.tag_list',  # 添加这一行
            ],
        },
    },
]

3. 修改navbar.html里的变量引用，把{{ object_list }}改成{{ tags }}，比如：

{% for tag in tags %}
    <a href="#">{{ tag.name }}</a>
{% endfor %}

这样不管访问哪个页面，tags变量都会自动出现在模板上下文里，导航栏就能正常显示数据了。

方案二：自定义模板标签（更灵活的按需加载） #

如果担心上下文处理器会在不需要的页面也执行数据库查询（虽然Tag.objects.all()是惰性查询，实际访问才会执行），可以用inclusion tag，只在导航栏模板里触发数据查询：

1. 在tags应用下新建templatetags文件夹，里面创建两个文件：__init__.py（空文件即可）和tag_extras.py（名字自定义）。

2. 在tag_extras.py里写入：

from django import template
from tags.models import Tag

register = template.Library()

@register.inclusion_tag('navbar_tags.html')  # 这里可以指定一个小模板来渲染标签
def load_tags():
    # 返回渲染模板需要的上下文
    return {'tags': Tag.objects.all()}

3. 新建navbar_tags.html（或者直接在原navbar.html里处理），写入标签的渲染逻辑：

{% for tag in tags %}
    <span class="tag-item">{{ tag.name }}</span>
{% endfor %}

4. 在navbar.html里先加载自定义标签，然后调用它：

{% load tag_extras %}

<!-- 导航栏其他内容 -->
<div class="tag-nav">
    {% load_tags %}
</div>

这个方案的好处是，只有当模板里调用{% load_tags %}时才会执行数据库查询，更灵活。

补充说明 #

• 注意把Tag.objects.all()改成你实际需要的查询逻辑（比如过滤状态、排序等），比如Tag.objects.filter(is_active=True).order_by('-created_at')。
• 上下文处理器的变量是全局的，所以命名要避免和其他视图的上下文变量冲突（比如不要用object_list，改用tags这种更明确的名字）。

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