模伴是一个包含响应文本的文件,其中包含用占位变量表示的动态部分,具体值只有在请求的上下文(request)中才能获取。
处理模板时,使用真实变量替换占位变量,再返回最终得到的响应字符串(文件),这一过程称为渲染,Flask使用了Jinjia2这一强大的模板引擎进行渲染操作。
一、Jinjia2 模版引擎
1、渲染模板
# user.html
Hello , {{ name }}
默认情况下,flask在程序根目录下的templates文件夹中寻找模板。
from flask import Flask, render_template
# flask提供的render_template函数将Jinjia2模版引擎集成到程序中
···
@app.route('/user/'
def user(name):
return render_template('user.html', name=name)
上述代码展示了render_template如何将动态变量传给模板并进行渲染
render_template函数接收多个参数,但第一个参数必须为模板文件名称,后续为表示动态变量的键值对。
2、变量
在模板中使用"{{ name }}",双大括号结构表示一个变量,是模板特有的占位符,用以告诉模板引擎这个位置从渲染模板时使用的数据中获取。
Jinjia2能识别所有类型的变量,包含复杂的(列表,字典,对象)。
# 复杂类型示例
{{ dict['key'] }}
{{ list[3] }}
{{ obj.somemethod() }}
并且Jinjia2支持使用过滤器修改变量,过滤器名添加在变量名之后,用竖线隔开。
{{ name | capitalize }}
完整的过滤器列表
3、控制结构
Jinjia2提供了多种控制结构用来改变模板的渲染流程。
{% if user %}
hello, {{ user }}
{% else %}
hello, Stranger!
{% endif %} #控制语句结束后必须使用 {% end+if/for...%}关闭
{% for comment in comments %}
- {{ comment }}
{% endfor %}
模板继承
{% extends "base.html" %}
{% block title %}
Index #为父模板的title标签添加内容
{% endblock %}
{% block head%}
{{ super() }} #获取父模版head标签内的内容
{% endblock %}
二、Flask-Bootstrap
Bootstrap是Twitter开发的一个客户端开源框架,并不会直接设计服务器内容。
服务器需要做的是提供引用了Bootstrap CSS和JS文件的HTML响应,并在HTML、CSS和JS中实例化所需组件,这些操作最理想的执行场所就是模板。
pip install flask-bootstrap #安装
from flask.ext.bootstrap import Bootstrap #引入
#···
bootstrap = Bootstrap(app) #初始化
使用extends指令从flask-bootstrap中导入bootstrap/base.html,从而实现模板继承。
该基模版提供了一个网页框架,引入Bootstrap所需的所有CSS、JS文件。
如果需要对已有内容的模版添加新内容,必须使用Jinjia2提供的super()函数
{% block scripts %}
{{ super() }}
{% endblock %}
三、自定义错误页面
为指定错误代码自定义错误处理程序
@app.errorhandler(404):
def page_not_found(e):
return render_template('404.html'), 404
需要编写404.html模版,继承base.html,并将head元素改为相应的错误信息。
为了避免过多的代码重复以及将错误信息展示在合适的页面,编写handle.html模板,继承自bootstrap/base.html,将导航条及其他基本框架必备信息写入,再新建404.html继承handle.html模板。
{% extends "handle.html" %}
{% block title %}Page Not Found {% endblock %}
{% block page_content %} Not Found
{% endblock %}
四、链接
任何具有多个路由的程序都需要可以连接不同页面的链接(例:导航条)
flask提供了url_for()辅助函数,可以使程序URL映射中保存的信息生成URL。
url_for()最简单的用法是以视图函数名作为参数,返回对应的URL。
使用url_for()生成动态地址时,将动态部分作为关键字参数传入。
传入url_for()的关键字参数不仅限于动态路由中的参数,函数能将任何额外的参数添加到查询字符串中,例:url_for('index', page=2) = /?page=2
五、静态文件
静态文件作为Web程序的重要组成部分(CSS、JavaScript、图片等)
默认设置下,flask会在程序根目录中名为static的子目录中寻找静态文件。
使用Flask-Moment本地化日期和时间
pip install flask-moment
from flask.ext.moment import Moment
moment = Moment(app)
当Web程序服务器不同地区和国家的用户时,日期显示是个非常关键的问题,一般来说要根据用户本地的时区来提供给用户本地化的时间。
flask-moment 是使用javascript开发的优秀客户端开源代码库,它可以在浏览器中渲染日期和时间。
{% block scripts %}
{{ super() }}
{{ moment.include_moment() }}
{% endblock %}
将时间变量传给模板进行渲染
#视图函数
from datetime import datetime
@app.route('/')
def index():
return render_template('index.html', current_time=datetime.utcnow())
#模板
That was {{ moment(current_time).format('LLL') }}
That was {{ moment(current_time).fromNow(refresh=True) }}
format('LLL')根据客户端电脑中的时区和区域设置渲染日期和时间,参数决定了渲染的方式,‘L’到‘LLL’分别对应不同的复杂度。
fromNow()渲染相对时间戳,而且会随着时间推移自动刷新显示的时间,最开始显示为"a few seconds ago",逐步变成"a minute ago"。