php模板引擎jinja,Python的Flask框架标配模板引擎Jinja2的使用教程

最新推荐文章于 2023-08-08 10:02:59 发布

渤海堂主人

最新推荐文章于 2023-08-08 10:02:59 发布

阅读量192

点赞数

文章标签： php模板引擎jinja

myapp/

__init__.py

models.py

views/

templates/

static/

run.py

requirements.txt

templates/

layout.html

index.html

about.html

profile/

layout.html

index.html

photos.html

admin/

layout.html

index.html

analytics.html

templates 目录的结构是与我们路由结构平行的。对于路由 myapp.com/admin/analytics 的模板就是 templates/admin/analytics.html。在目录里面还有一些额外的模板，它们不会直接地被渲染。layout.html 文件是为了让其它的模板继承。

继承很像蝙蝠侠的背景故事一样，一个组织优秀的模板目录很大程度上依靠继承。父模板通常定义一个通用的结构，所有子模板都能很好的继承它。在我们的例子中，layout.html 就是一个父模板而其它 .html 文件就是子模板。

你通常有一个顶层的 layout.html，它定义了你的应用程序的通用布局以及你的网站的每一部分。如果你看看上面的目录的话，你会看到一个顶层的 myapp/templates/layout.html，同样还有 myapp/templates/profile/layout.html 和 myapp/templates/admin/layout.html。最后两个文件继承和修改第一个文件。

{# _myapp/templates/layout.html_ #}

{% raw %}{% block title %}{% endblock %}{% endraw %}

{% block body %}

This heading is defined in the parent.

{% endblock %}

在子模板中，我们可以扩展父模板并且定义这些块的内容。

{# _myapp/templates/index.html_ #}

{% extends "layout.html" %}

{% block title %}Hello world!{% endblock %}

{% block body %}

This heading is defined in the child.

{% endblock %}

super() 函数让我们渲染父级块的内容。

创建宏我们可以在我们模板中坚持 DRY(不要重复自己)的原则，通过抽象出重复出现的代码片段到宏。如果我们正工作在为我们应用程序导航的 HTML 上，我们需要给一个 “活跃的”链接一个 class(class=”active”)。没有宏的话，我们要编写一大段 if ... else 语句，这些语句检查每一个链接找到正处于活跃的一个。

宏提供了一种模块化代码的方式；它们像函数一样工作。让我们看看如何使用宏标记一个活跃的链接。

{# myapp/templates/layout.html #}

{% from "macros.html" import nav_link with context %}

{% block head %}

My application

{% endblock %}{{ nav_link('home', 'Home') }}

{% block body %}

{% endblock %}

在这个模板中我们现在要做的就是调用一个未定义的宏 - nav_link -接着向其传递两个参数：目标端点(例如，目标视图的函数名)以及我们要显示的文本。

你可能会注意到在导入语句中我们指定了 with context。Jinja 的 context 是由传递到 render_template() 函数的参数以及来自我们的 Python 代码的 Jinja 环境上下文组成。对于模板来说，这些变量在模板被渲染的时候是可用的。

一些变量是明显地由我们传入，例如，render_template("index.html", color="red")，但是还有一些变量和函数是由 Flask 自动地包含在上下文中，例如，request, g 和 session。当我们说 {% raw %}{% from ... import ... with context %}{% endraw %} 的时候，就是告诉 Jinja 这些变量对宏也可用。

现在是时候定义在我们模板中使用的 nav_link 宏。

{# myapp/templates/macros.html #}

{% macro nav_link(endpoint, text) %}

{% if request.endpoint.endswith(endpoint) %}

现在我们已经在 myapp/templates/macros.html 中定义了宏。在这个宏中我们使用了 Flask 的 request 对象 — 默认情况下在 Jinja 上下文中是可用的 — 用来检查传入到 nav_link 中的路由的端点是否是当前请求。如果是，我们正在当前页面上，接着我们标记它为活跃的。

从 x 导入 y 语句采用了 x 的相对路径。如果我们的模板是 myapp/templates/user/blog.html，我们可以在使用 from "../macros.html" 导入 nav_link。

自定义过滤器Jinja 过滤器是一个函数，它能够在 {% raw %}{{ ... }}{% endraw %} 中用于处理一个表达式的结果。在表达式结果输出到模板之前它就被调用。

在这段代码中，title 过滤器接收 article.title 作为参数并且返回一个过滤后的标题，接着过滤后的标题将会输出到模板中。这就像 UNIX 的“管道化”一个程序到另一个程序的输出。

有很多像 title 一样的内置过滤器。请参阅 Jinja 文档中的完整列表。

我们可以在我们的 Jinja 模板中定义自己的过滤器供使用。举例来说，我们将会实现一个简单 caps 过滤器用来大写一个字符串中所有的字母。

Jinja 已经有一个 upper 过滤器来做这样的事情，并且还有一个 capitalize 过滤器，它能用来大写第一个字母，小写其余的字母。这些也能处理 unicode 转换，但是我们会继续我们的示例，让大家目前能够知道如何自定义过滤器。

我们要在 myapp/util/filters.py 中定义我们的过滤器。这里给出一个 util 包，它里面有各种各样的模块。

# myapp/util/filters.py

from .. import app

@app.template_filter()

def caps(text):

"""Convert a string to all caps."""