模块是一个包含响应文本的文件,其中包含占用位变量表示的动态部分,其具体值只在请求的上下文中才知道。使用真实值替换变量,再返回最终得到的响应字符串,这一过程称为渲染。为了渲染模块,Flask使用一个名为Jinja2的强大模板引擎。
一、Jinja2模板引擎
形式最简单的Jinja2模板就是一个包含响应文本的文件。
1、渲染模板
默认情况下,Flask在程序文件夹中的templates子文件夹中寻找模板。在下一个hello.py版本中,要把前面定义的模板保存在templates文件夹中,并分别命名为index.html和user.html。
#!/usr/bin/env python
from flask import Flask,render_template
app = Flask(__name__)
@app.route('/')
def index():
return render_template('index.html')
@app.route('/user/')
def user(name):
return render_template('user.html',name=name)
if __name__ == '__main__':
app.run()
Flask提供的render_template函数把Jinja模块引擎集成到了程序中。
2、变量
模板中使用的{{name}}结构表示一个变量,它是一种特殊的占位符,告诉模板引擎这个位置的值从渲染模板时使用的数据中获取。
Jinja2能识别所有类型的变量,甚至是一些复杂的类型,例如列表、字典和对象。在模板中使用变量的一些实例如下
a value from a dictionary: {{ mydict['key'] }}
a value from a list:{{ mylist[3] }}
a value from a list,with a varliable index:{{ mylist[myintavr] }}
a value from a objects method:{{ myobj.somemethod() }}
Jinja2变量过滤器
过滤器名
说明
safe
、渲染时不转义
capitalize
把值得首字母转换成大写,其他字母转换成小写
lower
把值转换成小写形式
upper
把值转换成大写形式
title
把值中每个单词的首字母都转换成大写
trim
把值的首位空格去掉
striptags
渲染之前把值中所有HTML标签都删除
3、控制结构
在模板中使用条件控制语句:
{% if user %}
Hello,{{ user }}!
{% else %}
Hello,Stranger!
{% endif %}
{% for commet in commets %}
{{ commet }}{% end for %}
Jinja2还支持宏,类似于Python代码中的函数。例如:
{% macro render_commet(commet) %}
{{ commet }}{% endmacro %}
{% for commet in commets %}
{{ render_commet(commet) }}
{% endfor %}
为了重复使用宏,我们可以将其保存在单独的文件中,然后在需要使用的模板中导入:
{% import 'macros.html' as macros %}
{% for commet in commets %}
{{ macros.render_commet(commet) }}
{% endfor %}
另一种重复使用代码的强大方式是模板继承,它类似于Python代码中的类继承。首先创建一个名为base.html的基模板:
{% block head %}
{% block title %}{% endblock %} - My Application{% endblock %}
{% block body %}
{% endblock %}
二、使用Flask-Bootstrap集成Twitter Bootstrp
Bootstrap是客户端架构,因此不会直接涉及服务器。服务器要做的知识提供引用了Bootstrap层叠样式表(CSS)和Javascript文件的HTML响应,并在HTML/CSS和Javascript代码中实例化所需组件。这些操作最理想的执行场所就是模板。
#初始化 Flask-bootstrap
from flask.ext.bootstrap import Bootstrap
#...
bootstrap = Bootstrap(app)
初始化Flask-Bootstrap之后,就可以在程序中使用一个包含所有Bootstrap文件的基模板。
{% extends "bootstrap/base.html" %}
{% block title %}Flasky{% endblock %}
{% block navbar %}
{% endblock %}
{% block content %}
{% endblock %}
三、自定义错误界面
#自定义错误界面
#!/usr/bin/env python
from flask import Flask,render_template
app = Flask(__name__)
@app.errorhandler(404)
def page_not_found(e):
return render_template('404.html'),404
@app.errorhandler(500)
def internal_server_error(e):
return render_template('500.html'),500
if __name__ == '__main__':
app.run()
四:链接
Flask提供url_for()辅助函数,它可以使用程序URL映射中保存的信息生成URL。
url_for()函数最简单的用法是以视图函数名(或者app.add_url_route()定义路由时使用的端点名)作为参数,返回对应的URL。
使用url_for()生成动态地址时,将动态部分作为关键字参数传入。例如,url_for('user',name='john',_external=True)
五、静态文件
默认设置下,Flask在程序根目录中名为static的子目录中寻找静态文件。如果需要,可在static文件夹中使用子文件夹存放文件。
#定义收藏夹图标
{% block head %}
{{ super() }}
type="image/x-icon">
type="image/x-icon">
{% endblock %}
六、使用Flask-Moment本地化日期和时间
Flask-Moment是一个Flask程序扩展,能把moment.js集成到Jinja2模板中。
#初始化Flask-Moment
from flask.ext.moment import Moment
moment = Moment(app)
#引入moment.js库
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}
#!/usr/bin/env python
from flask import Flask,render_template
app = Flask(__name__)
from datetime import datetime
from flask_moment import Moment
moment = Moment(app)
@app.route('/')
def index():
return render_template('index.html',
current_time=datetime.utcnow())
if __name__ == '__main__':
app.run()