本文实例讲述了Python Flask框架模板操作。分享给大家供大家参考,具体如下:
模板
在前面的示例中,视图函数的主要作用是生成请求的响应,这是最简单的请求。实际上,视图函数有两个作用:处理业务逻辑和返回响应内容。在大型应用中,把业务逻辑和表现内容放在一起,会增加代码的复杂度和维护成本。本节学到的模板,它的作用即是承担视图函数的另一个作用,即返回响应内容。 模板其实是一个包含响应文本的文件,其中用占位符(变量)表示动态部分,告诉模板引擎其具体值需要从使用的数据中获取。使用真实值替换变量,再返回最终得到的字符串,这个过程称为“渲染”。Flask使用Jinja2这个模板引擎来渲染模板。Jinja2能识别所有类型的变量,包括{}。 Jinja2模板引擎,Flask提供的render_template函数封装了该模板引擎,render_template函数的第一个参数是模板的文件名,后面的参数都是键值对,表示模板中变量对应的真实值。
Jinja2官方文档(http://docs.jinkan.org/docs/jinja2/)
我们先来认识下模板的基本语法:
{% if user %} {{ user }} {% else %} hello! <ul> {% for index in indexs %} <li> {{ index }} </li> </ul>
通过修改一下前面的示例,来学习下模板的简单使用:
@app.route('/') def hello_itcast(): return render_template('index.html') @app.route('/user/<name>') def hello_user(name): return render_template('index.html',name=name)
变量
在模板中{{ variable }}结构表示变量,是一种特殊的占位符,告诉模板引擎这个位置的值,从渲染模板时使用的数据中获取;Jinja2除了能识别基本类型的变量,还能识别{};
<span>{{mydict['key']}}</span> <br/> <span>{{mylist[1]}}</span> <br/> <span>{{mylist[myvariable]}}</span>
from flask import Flask,render_template app = Flask(__name__) @app.route('/') def index(): mydict = {'key':'silence is gold'} mylist = ['Speech', 'is','silver'] myintvar = 0 return render_template('vars.html', mydict=mydict, mylist=mylist, myintvar=myintvar ) if __name__ == '__main__': app.run(debug=True)
反向路由: Flask提供了url_for()辅助函数,可以使用程序URL映射中保存的信息生成URL;url_for()接收视图函数名作为参数,返回对应的URL;
如调用url_for('index',_external=True)返回的是绝对地址,在下面这个示例中是http://localhost:5000/。
如调用url_for('index',name='apple',_external=True)返回的是:
http://localhost:5000/index/apple:
@app.route('/') def hello_itcast(): return render_template('index.html') @app.route('/user/<name>') def hello_user(name): return url_for('hello_itcast',_external=True)
自定义错误页面:
from flask import Flask,render_template @app.errorhandler(404) def page_not_found(e): return render_template('404.html'), 404
过滤器:
过滤器的本质就是函数。有时候我们不仅仅只是需要输出变量的值,我们还需要修改变量的显示,甚至格式化、运算等等,这就用到了过滤器。 过滤器的使用方式为:变量名 | 过滤器。 过滤器名写在变量名后面,中间用 | 分隔。如:{{variable | capitalize}},这个过滤器的作用:把变量variable的值的首字母转换为大写,其他字母转换为小写。 其他常用过滤器如下:
safe:禁用转义;
<p>{{ '<em>hello</em>' | safe }}</p>
capitalize:把变量值的首字母转成大写,其余字母转小写;
<p>{{ 'hello' | capitalize }}</p>
lower:把值转成小写;
<p>{{ 'HELLO' | lower }}</p>
upper:把值转成大写;
<p>{{ 'hello' | upper }}</p>
title:把值中的每个单词的首字母都转成大写;
<p>{{ 'hello' | title }}</p>
trim:把值的首尾空格去掉;
<p>{{ ' hello world ' | trim }}</p>
reverse:字符串反转;
<p>{{ 'olleh' | reverse }}</p>
format:格式化输出;
<p>{{ '%s is %d' | format('name',17) }}</p>
striptags:渲染之前把值中所有的HTML标签都删掉;
<p>{{ '<em>hello</em>' | striptags }}</p>
语句块过滤(不常用):
{% filter upper %} this is a Flask Jinja2 introduction {% endfilter %}
自定义过滤器:
通过Flask应用对象的add_template_filter方法,函数的第一个参数是过滤器函数,第二个参数是过滤器名称。然后,在模板中就可以使用自定义的过滤器。
def filter_double_sort(ls): return ls[::2] app.add_template_filter(filter_double_sort,'double_2')
Web表单:
web表单是web应用程序的基本功能。
它是HTML页面中负责数据采集的部件。表单有三个部分组成:表单标签、表单域、表单按钮。表单允许用户输入数据,负责HTML页面数据采集,通过表单将用户输入的数据提交给服务器。
在Flask中,为了处理web表单,我们一般使用Flask-WTF扩展,它封装了WTForms,并且它有验证表单数据的功能。
WTForms支持的HTML标准字段
WTForms常用验证函数
使用Flask-WTF需要配置参数SECRET_KEY。
CSRF_ENABLED是为了CSRF(跨站请求伪造)保护。 SECRET_KEY用来生成加密令牌,当CSRF激活的时候,该设置会根据设置的密匙生成加密令牌。
<form method='post'> <input type="text" name="username" placeholder='Username'> <input type="password" name="password" placeholder='password'> <input type="submit"> </form>
from flask import Flask,render_template @app.route('/login',methods=['GET','POST']) def login(): if request.method == 'POST': username = request.form['username'] password = request.form['password'] print username,password return render_template('login.html',method=request.method)
配置参数:
app.config['SECRET_KEY'] = 'silents is gold' {{ form.username.label }} {{ form.username() }} {{ form.password.label }} {{ form.password() }} {{ form.submit() }}
我们通过登录页面来演示表单的使用。
#coding=utf-8 from flask import Flask,render_template, flash,redirect,url_for,session #导入WTF扩展包的Form基类 from flask_wtf import Form from wtforms.validators import DataRequired,EqualTo from wtforms import StringField,PasswordField,SubmitField app = Flask(__name__) #设置secret_key,防止跨站请求攻击 app.config['SECRET_KEY'] = '2017' #自定义表单类,继承Form class Login(Form): us = StringField(validators=[DataRequired()]) ps = PasswordField(validators=[DataRequired(),EqualTo('ps2','error')]) ps2 = PasswordField(validators=[DataRequired()]) submit = SubmitField() #定义视图函数,实例化自定义的表单类, @app.route('/',methods=['GET','POST']) def forms(): #实例化表单对象 form = Login() if form.validate_on_submit(): #获取表单数据 user = form.us.data pswd = form.ps.data pswd2 = form.ps2.data print user,pswd,pswd2 session['name'] = form.us.data flash(u'登陆成功') return redirect(url_for('forms')) else: print form.validate_on_submit() return render_template('forms.html',form=form) if __name__ == "__main__": app.run(debug=True)
控制语句
常用的几种控制语句:
模板中的if控制语句
@app.route('/user') def user(): user = 'dongGe' return render_template('user.html',user=user)
<html> <head> {% if user %} <title> hello {{user}} </title> {% else %} <title> welcome to flask </title> {% endif %} </head> <body> <h1>hello world</h1> </body> </html>
模板中的for循环语句
@app.route('/loop') def loop(): fruit = ['apple','orange','pear','grape'] return render_template('loop.html',fruit=fruit)
<html> <head> {% if user %} <title> hello {{user}} </title> {% else %} <title> welcome to flask </title> {% endif %} </head> <body> <h1>hello world</h1> <ul> {% for index in fruit %} <li>{{ index }}</li> {% endfor %} </ul> </body> </html>
宏:
类似于python中的函数,宏的作用就是在模板中重复利用代码,避免代码冗余。
Jinja2支持宏,还可以导入宏,需要在多处重复使用的模板代码片段可以写入单独的文件,再包含在所有模板中,以避免重复。
定义宏
{% macro input() %} <input type="text" name="username" value="" size="30"/> {% endmacro %}
调用宏
{{ input()}} #定义带参数的宏 #调用宏,并传递参数 <input type="password" name="" value="name" size="40"/>
模板继承:
模板继承是为了重用模板中的公共内容。{% block head %}标签定义的元素可以在衍生模板中修改,extends指令声明这个模板继承自哪?父模板中定义的块在子模板中被重新定义,在子模板中调用父模板的内容可以使用super()。
{% extends 'base.html' %} {% block content %} <h1> hi,{{ name }} </h1> {% for index in fruit %} <p> {{ index }} </p> {% endfor %} {% endblock %}
Flask中的特殊变量和方法:
在Flask中,有一些特殊的变量和方法是可以在模板文件中直接访问的。
config 对象:
config 对象就是Flask的config对象,也就是 app.config 对象。
{{ config.SQLALCHEMY_DATABASE_URI }}
request 对象:
就是 Flask 中表示当前请求的 request 对象。
{{ request.url }}
url_for 方法:
url_for() 会返回传入的路由函数对应的URL,所谓路由函数就是被 app.route() 路由装饰器装饰的函数。如果我们定义的路由函数是带有参数的,则可以将这些参数作为命名参数传入。
{{ url_for('index') }} {{ url_for('post', post_id=1024) }}
get_flashed_messages方法:
返回之前在Flask中通过 flash() 传入的信息列表。把字符串对象表示的消息加入到一个消息队列中,然后通过调用 get_flashed_messages() 方法取出。
{% for message in get_flashed_messages() %} {{ message }} {% endfor %}
希望本文所述对大家基于flask框架的Python程序设计有所帮助。