第三章--模版

模伴是一个包含响应文本的文件,其中包含用占位变量表示的动态部分,具体值只有在请求的上下文(request)中才能获取。
处理模板时,使用真实变量替换占位变量,再返回最终得到的响应字符串(文件),这一过程称为渲染,Flask使用了Jinjia2这一强大的模板引擎进行渲染操作。

一、Jinjia2 模版引擎

1、渲染模板

# user.html
<h1>Hello , {{ name }}  </h1>

默认情况下,flask在程序根目录下的templates文件夹中寻找模板。

from flask import Flask, render_template
# flask提供的render_template函数将Jinjia2模版引擎集成到程序中
···
@app.route('/user/<name>'
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...%}关闭

<ul>
    {% for comment in comments %}
        <li>{{ comment }}</li>
    {% endfor  %}
</ul>

模板继承

{% 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() }}
<script type="text/javascript" src="my-script.js"></script>
{% 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 %} <h1>Not Found</h1>{% 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())
#模板
<p>That was {{ moment(current_time).format('LLL')  }}</p>
<p>That was {{ moment(current_time).fromNow(refresh=True) }}</p>

format('LLL')根据客户端电脑中的时区和区域设置渲染日期和时间,参数决定了渲染的方式,‘L’到‘LLL’分别对应不同的复杂度。
fromNow()渲染相对时间戳,而且会随着时间推移自动刷新显示的时间,最开始显示为"a few seconds ago",逐步变成"a minute ago"。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,519评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,842评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,544评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,742评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,646评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,027评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,513评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,169评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,324评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,268评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,299评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,996评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,591评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,667评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,911评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,288评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,871评论 2 341

推荐阅读更多精彩内容