context_processor 上下文处理器 context_processor 上下文处理器

博客里面有三个地方用到了标签云:主页面,分类页面,博客详情页面,于是有了下面一段代码

# 主页面
@main.route("/")
def index():
    tags = Tag.query.all()
    # ...省略部分代码
    return render_html("index.html", tags=tags,)

# 分类页面
@main.route("tag/<int:id>")
def tags(id):
    tags = Tag.query.all()
    # ...省略部分代码
    return render_html("tags.html", tags=tags,)

# 博客详情页面
@main.route("post/<int:id>")
def post(id):
    tags = Tag.query.all()
    # ...省略部分代码
    return render_html("post.html", tags=tags,post=post)

好像问题解决了?所有页面都能显示出来标签云了? 但是这三个页面都回传 tags 会不会太难看了一些,完全不优雅了嘛,有没有好的办法呢? 答案自然是有的,接下来就到我们的重点了。

context_processor 闪亮登场

跟我们之前的说到的钩子函数一样,它也有一个兄弟--app_context_processor,区别很简单,后者是针对蓝图的。让我们看一下它的官方定义:

Registers a template context processor function.

翻译过来很简单: 注册模板上下文处理器功能。 这个真能解决我们的问题吗?别着急让我们试一下,把之前的代码改造一下。

@main.app_context_processor
def peach_blog_menu():
    tags = Tag.query.all()
    return dict(tags=tags)

@main.route("/")
def index():
    # ...省略部分代码
    return render_html("index.html")

# 分类页面
@main.route("tag/<int:id>")
def tags(id):
    # ...省略部分代码
    return render_html("tags.html")

# 博客详情页面
@main.route("post/<int:id>")
def post(id):
    tags = Tag.query.all()
    # ...省略部分代码
    return render_html("post.html")

是不是发现什么消失了? tags 好像从之前的几个函数中消失了,没有回传到前台,能访问到吗?自然是可以的。原因自然是 context_processor 了,它可以将我们的定义变量在所有模板中可见。

如何使用呢?

1. 如上述代码那样, context_processor 作为一个装饰器修饰一个函数

2. 函数的返回结果必须是 dict, 然后其 key 将会作为变量在所有模板中可见

 

当你的很多视图函数中需要回传一个相同的变量的时候,这个时候就可以考虑使用 context_processor 了