Flask从入门到精通之Flask-Bootstrap的使用

　　Bootstrap（http://getbootstrap.com/）是Twitter 开发的一个开源框架，它提供的用户界面组件可用于建立整洁且具备吸引力的网页，并且这些网页还能兼容全部现代Web 浏览器。

　　要想在程序中集成Bootstrap，显然要对模板作全部必要的改动。不过，更简单的方法是使用一个名为Flask-Bootstrap 的Flask 扩展，简化集成的过程。Flask-Bootstrap 使用pip安装：

pip install flask_bootstrap

　　Flask 扩展通常都在建立程序实例时初始化，下面是Flask_Bootstrap的初始化方法

from flask.ext.bootstrap import Bootstrap
bootstrap = Bootstrap(app)

　　初始化Flask-Bootstrap 以后，就能够在程序中使用一个包含全部Bootstrap 文件的基模板。这个模板利用Jinja2 的模板继承机制，让程序扩展一个具备基本页面结构的基模板，其中就有用来引入Bootstrap 的元素。

{%extends "bootstrap/base.html"%}

{%block title %}Flask{% endblock %}

{%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">
    <div class="page-header">
        <h1>Hello, {{ name }}!</h1>
    </div>
</div>
{% endblock %}

　　Jinja2 中的extends 指令从Flask-Bootstrap 中导入bootstrap/base.html， 从而实现模板继承。Flask-Bootstrap 中的基模板提供了一个网页框架，引入了Bootstrap 中的全部CSS 和JavaScript 文件。基模板中定义了可在衍生模板中重定义的块。block 和endblock 指令定义的块中的内容可添加到基模板中。上面这个user.html 模板定义了3 个块，分别名为title、navbar 和content。这些块都是基模板提供的，可在衍生模板中从新定义。title 块的做用很明显，其中的内容会出如今渲染后的HTML 文档头部，放在<title> 标签中。navbar 和content 这两个块分别表示页面中的导航条和主体内容。在这个模板中，navbar 块使用Bootstrap 组件定义了一个简单的导航条。content 块中有个<div> 容器，其中包含一个页面头部。以前版本的模板中的欢迎信息，如今就放在这个页面头部。运行结果以下图：　　　　

Flask-Bootstrap 的base.html 模板还定义了不少其余块，均可在衍生模板中使用，下表列出了全部可用的块：

 

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

　　上表中的不少块都是Flask-Bootstrap 自用的，若是直接重定义可能会致使一些问题。例如，Bootstrap 所需的文件在styles 和scripts 块中声明。若是程序须要向已经有内容的块中添加新内容，必须使用Jinja2 提供的super() 函数。例如，若是要在衍生模板中添加新的JavaScript 文件，须要这么定义scripts 块：

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