第六篇：使用flask-Bootstrap集成bootstrap

1:安装：pip installflask-bootstrap
2:初始化：

from flaskf_bootstarp import Bootstrap
bootstrap=Bootstrap(app)

实例例：

{% extends "bootstrap/base.html" %} #extends 指令从flask-bootstrap中导入bootstarp/base.html，实现模板继承
{% block title %}Flasky{% endblock %}#将title 的内容添加标题
{% block navbar %} #导航栏设置
<div class="navbar navbar-inverse" role="navigation">
	<div class="container">
		<div class="navbar-header">
			<button type="button" class="navbar-toggle"data-toggle="collapse" data-target=".navbar-collapse">
				<span class="sr-only">Toggle navigation</span>
				<span class="icon-bar"></span>
				<span class="icon-bar"></span>
				<span class="icon-bar"></span>
			</button>
			<a class="navbar-brand" href="/">Flasky</a>
		</div>
		<div class="navbar-collapse collapse">
			<ul class="nav navbar-nav">
			<li><a href="/">Home</a></li>
		</ul>
		</div>
	</div>
</div>
{% endblock %}
{% block content %} #内容设置
<div class="container">
{% block page_content %}{% endblock %}
</div>
{% endblock %}

3：flask-bootstrap基模块中定义的区块：

块　　名	说　　明
doc	整个 HTML 文档
html_attribs	html标签的属性
html	html标签的属性
head	head 标签中的内容
title	title 标签中的内容
metas	一组 标签
styles	层叠样式表定义
body_attribs	标签的属性
body	标签中的内容
navbar	用户定义的导航条
content	用户定义的页面内容
scripts	文档底部的 JavaScript 声明

如果在新的衍生模板中添加新的js文件，需要这么定义scripts区块：

{% block scripts %}
{{ super() }}
<script type="text/javascript" src="my-script.js"></script>
{% endblock %}

4：定义错误界面
如果在页面中输入无效的路由，会看到一个404的错误页面，用app.errorhandler装饰器为404，500两个错误提供自定义的函数：

@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

5：链接：任何具有多个路由的程序都需要可以连接不同页面的链接，例如导航条。
在模板中直接编写简单路由的 URL 链接不难，但对于包含可变部分的动态路由，在模板
中构建正确的 URL 就很困难。而且，直接编写 URL 会对代码中定义的路由产生不必要的
依赖关系。如果重新定义路由，模板中的链接可能会失效，为了避免这些问题，Flask 提供了 url_for() 辅助函数，它可以使用程序 URL 映射中保存
的信息生成 URL。
url_for() 函数最简单的用法是以视图函数名（或者 app.add_url_route() 定义路由时使用
的端点名）作为参数，返回对应的 URL。例如，在当前版本的 hello.py 程序中调用 url_
for(‘index’) 得到的结果是 / 。调用 url_for(‘index’, _external=True) 返回的则是绝对地
址，在这个示例中是 http://localhost:5000/。
使用 url_for() 生成动态地址时，将动态部分作为关键字参数传入。例如， url_for
(‘user’, name=‘john’, _external=True) 的返回结果是 http://localhost:5000/user/john。
传入 url_for() 的关键字参数不仅限于动态路由中的参数。函数能将任何额外参数添加到
查询字符串中。例如， url_for(‘index’, page=2) 的返回结果是 /?page=2。
例：

{% block head %}
{{ super() }}
<link rel="shortcut icon" href="{{ url_for('static', filename = 'favicon.ico') }}"
type="image/x-icon">
<link rel="icon" href="{{ url_for('static', filename = 'favicon.ico') }}"
type="image/x-icon">
{% endblock %}

6：静态文件
Web 程序不是仅由 Python 代码和模板组成。大多数程序还会使用静态文件，例如 HTML
代码中引用的图片、JavaScript 源码文件和 CSS。
你可能还记得在第 2 章中检查 hello.py 程序的 URL 映射时，其中有一个 static 路由。
这是因为对静态文件的引用被当成一个特殊的路由，即 /static/。例如，调用
url_for(‘static’, filename=‘css/styles.css’, _external=True) 得 到 的 结 果 是 http://
localhost:5000/static/css/styles.css。
默认设置下，Flask 在程序根目录中名为 static 的子目录中寻找静态文件。如果需要，可在
static 文件夹中使用子文件夹存放文件。服务器收到前面那个 URL 后，会生成一个响应，
包含文件系统中 static/css/styles.css 文件的内容。

示例：展示了如何在程序的基模板中放置 favicon.ico 图标。这个图标会显示在浏览器的
地址栏中。templates/base.html：定义收藏夹图标

{% block head %}
{{ super() }}
<link rel="shortcut icon" href="{{ url_for('static', filename = 'favicon.ico') }}"
type="image/x-icon">
<link rel="icon" href="{{ url_for('static', filename = 'favicon.ico') }}"
type="image/x-icon">
{% endblock %}

图标的声明会插入 head 块的末尾。注意如何使用 super() 保留基模板中定义的块的原始
内容。
7：使用Flask-Moment本地化日期和时间
如果 Web 程序的用户来自世界各地，那么处理日期和时间可不是一个简单的任务。
服务器需要统一时间单位，这和用户所在的地理位置无关，所以一般使用协调世界时
（Coordinated Universal Time，UTC）。不过用户看到 UTC 格式的时间会感到困惑，他们更
希望看到当地时间，而且采用当地惯用的格式。
要想在服务器上只使用 UTC 时间，一个优雅的解决方案是，把时间单位发送给 Web 浏览
器，转换成当地时间，然后渲染。Web 浏览器可以更好地完成这一任务，因为它能获取用
户电脑中的时区和区域设置。
有一个使用 JavaScript 开发的优秀客户端开源代码库，名为 moment.js（http://momentjs.
com/），它可以在浏览器中渲染日期和时间。Flask-Moment 是一个 Flask 程序扩展，能把
moment.js 集成到 Jinja2 模板中。Flask-Moment 可以使用 pip 安装：(venv) $ pip install flask-moment
1：初始化：

from flask.ext.moment import Moment
moment = Moment(app)

除了 moment.js，Flask-Moment 还依赖 jquery.js。要在 HTML 文档的某个地方引入这两个
库，可以直接引入，这样可以选择使用哪个版本，也可使用扩展提供的辅助函数，从内容
分发网络（Content Delivery Network，CDN）中引入通过测试的版本。Bootstrap 已经引入
了 jquery.js，因此只需引入 moment.js 即可。示例 3-12 展示了如何在基模板的 scripts 块
中引入这个库。
示例：　templates/base.html：引入 moment.js 库

**{% block head  %}
{{ super() }}
{{ moment.include_jquery() }}
{{ moment.include_moment() }}
{% endblock %}**

为了处理时间戳，Flask-Moment 向模板开放了 moment 类。示例 中的代码把变量
current_time 传入模板进行渲染。
2：templates/index.html：使用 Flask-Moment 渲染时间戳

<p>The local date and time is {{ moment(current_time).format('LLL') }}.</p>
<p>That was {{ moment(current_time).fromNow(refresh=True) }}</p>