flask框架渲染Jinja模板与传入模板变量操作详解

发布时间：2020-08-19 14:31:46 作者：stu_xujin
来源：脚本之家阅读：170

本文实例讲述了flask框架渲染Jinja模板与传入模板变量操作。分享给大家供大家参考，具体如下：

1. 模板简介

模板是一个web开发中必备的模块，因为我们在渲染一个网页的时候，并不只是渲染了一个纯文本字符窜，而是渲染一个有富文本标签的页面，这个时候我们就需要用到模板了。在flask中，配套的模板是Jinja2,Jinja2的作者也是flask的作者。

2. flask中渲染模板

在flask中，如果我们需要渲染一个模板，那么我们就需要用到render_template这个方法了。

在我们新建一个flask项目的时候，会同时生成一个templates的文件夹，然后我们就在里面新建一个index.html的文件。然后写入测试代码:

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>index</title>
</head>
<body>
 <h2>index</h2>
</body>
</html>

然后我们在app.py文件中写一个视图函数渲染我们的index.html文件。

from flask import render_template
@app.route('/index/')
def index():
  return render_template('index.html')

这样，我们就成功的对html页面进行了渲染。然后我们运行项目，输入网址就能够查看到效果了。

3. flask中模板文件查找路径

在上面的render_template函数中，为什么我们直接写入index.html，flask就会知道去templates文件夹里面去找这个文件呢。而不是去其他位置查找index.html文件呢。这是因为在flask中，默认的查找模板路劲就在项目的根目录下面的templates文件夹。所以当我们写模板文件的时候，都会写在templates下面。

在flask中，我们也是可以修改模板的存放位置的，比如我们将模板文件存放位置修改为E:\templates，那么我们就可以这样写。

from flask import Flask,render_template
app = Flask(__name__,template_folder=r'E:\templates')

这样，flask每次查找模板文件路径的时候，就回去这个文件夹下面寻找，如果没有找到，就会报一个jinja2.exceptions.TemplateNotFound的错误，所以，当我们遇到了这个错误的时候，我们就要知道是哪个位置出问题了。

4. 模板中传入参数

在一个模板中，我们不可避免的会传入一些参数，那么在flask中，应该怎样闯入参数呢。

首先编写一个视图，然后在render_template中传入一个关键字参数，例如下面的username=‘xxx'

from flask import render_template
@app.route('/index/')
def index():
  return render_template('index.html',username='xxx')

然后我们在模板中怎样使用这个变量呢？我们在index.html中写入以下代码

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>index</title>
</head>
<body>
 <h2>index</h2>
 <p>userneme: {{ username }}</p>
</body>
</html>

所以，我们在模板中通过 {{ username }}就可以拿到我们冲视图中传入的值了。也就是说，在Jinja2模板中，是通过{{ 变量名 }}来获取数据的，如果我们在{{ }}中传入了一个视图并没有穿给我们的变量，那么也不会报错，只是什么都不显示而已。

如果我们需要传入多个参数，只需要依次在render_template函数中传入我们的关键之参数就可以了。
示例：

return render_template('index.html',username='xxx',age=18,...)

但是如果我们参数很多的话，那么这样我们也不方便我们管理和查看，这个时候我们就可以换一种方式了，定义一个字典，来存放所有的变量，然后在传入模板中

示例：

@app.route('/index/')
def index():
 context = {
 'username':'xxx',
 'age':18,
 'height':180,
 }
  return render_template('index.html',context=context)

但是这个时候，当我们在模板找中直接输入{{ username }}，{{ age }}, {{ height }}的时候，是获取不到我们的数据的，因为我们使用这种方法的话，在模板中，获取参数就需要改变一下方式了。变成下面这样.

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>index</title>
</head>
<body>
 <h2>index</h2>
 <p>userneme: {{ context.username }}</p>
 <p>userneme: {{ context['age'] }}</p>
 <p>userneme: {{ context.height }}</p>
</body>
</html>

在上面模板中，我们使用了两种方式得到参数，context['username']和context.username。因为context是一个字典，所以使用这两种方法都是可以的。

但是这样我们仍然觉得不方便，每次都需要通过context才能获取到我们传入的参数。那么我们可不可以不通过context才能获取参数呢，答案是可以的。

实例：

@app.route('/index/')
def index():
 context = {
 'username':'xxx',
 'age':18,
 'height':180,
 }
  return render_template('index.html',**context)

我们在视图函数中这样写，我们就需要通过context才能得到我们的参数了。

**context其实就是将这个字典打撒开来，形成关键字参数。所以，他和下面这种写法是完全一样的。

@app.route('/index/')
def index():
  return render_template('index.html',username='xxx',age=18,height=180)

一般我们在项目的开发中，我们都是使用**context这种写法。

当然，在我们的实际开发中，传送的数据肯定不是这么简单，一般都有数据嵌套之类的，还有对象。
例如下面这样:

# 定义一个Person类
class Person():
  def __init__(self,name,age):
    self.name = name
    self.age = age
person = Person('小明', 18) # 实例化一个Person对象
@app.route('/')
def index():
  context = {
    'username':'xujin',
    'age':18,
    'children':{
      'name':'hah',
      'height':190,
    },
    'person':person,
    'list':[1,2,3]
  }
  return render_template('index.html',**context)

其实在Jinja2模板中，我们对数据的操作和在python都是差不多的，像上面这种数据，我们就可以通过下面的方式来获取。

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>index</title>
</head>
<body>
<h2>index</h2>
hello {{ username }}
<p> {{ children.name}} </p>
<p> {{ children['height'] }} </p>
{{ person }}
{{ person.name }}
{{ person.age }}
{{ list }}
{{ list[1] }}
</body>
</html>

5. url_for的使用

在模板中，我们一般也少不了需要url地址，而我们直接手动写入url地址的话,不方便我们后面的管理，所以一般我们都会使用url_for函数构造我们的url。

比如我们有一个login页面，然后我么需要从首页点击登录之后，就跳转至login页面，那么我们需要这样做。

@app.route('/login/')
def login():
  return "这是login页面"
@app.route('/index/')
def login():
  return render_template('index.html')

然后我们在index.html中写入

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>index</title>
</head>
<body>
<h2>index</h2>
<p><a href="/login/" rel="external nofollow" >登陆</a></p>
<p><a href="{{ url_for('login') }}" rel="external nofollow" >登陆</a></p>
</body>
</html>

上面两种方式一种是直接写死url的方式，一种就是使用url_for的的方式。一般我们都是会使用url_for这种方式的。

如果我们的url需要参数，那么其实和在视图中传入参数是一样的。

示例：

@app.route('/user/<int:user_id>/')
def user(user_id):
 return "user id is %s " % user_id

模板文件中写入

<a href="{{ url_for('user',user_id=1,next='xxx') }}" rel="external nofollow" >user</a>
<!-- 等价于下面这样 -->
<a href="/user/1/?next=xxx" rel="external nofollow" >user</a>

希望本文所述对大家基于flask框架的Python程序设计有所帮助。