第三章--模版

模伴是一个包含响应文本的文件,其中包含用占位变量表示的动态部分,具体值只有在请求的上下文(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"。

你可能感兴趣的:(第三章--模版)