本文实例讲述了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>
- <h1>index</h1>
- </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>
- <h1>index</h1>
- <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>
- <h1>index</h1>
- <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>
- <h1>index</h1>
- 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>
- <h1>index</h1>
- <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程序设计有所帮助。