Flask 框架集成Bootstrap
前面学习了 Flask 框架的基本用法，以及模板引擎 Jinja2，按理说可以开始自己的 Web 之旅了，不过在启程之前，还有个重要的武器需要了解一下，就是著名的 Bootstrap 框架和 Flask 的结合，这将大大提高开发 Web 应用的效率。
简介
Bootstrap 是 Twitter 公司的设计师 Mark Otto 和 Jacob Thornton 开发的 Web 项目开发框架，简洁、直观、强悍，使得 Web 开发更加快捷，一经推出后颇受欢迎，一直是 GitHub 上的热门开源项目，这么好的开发框架 Flask 一定少不了。
期初在 Flask 的扩展包中有 flask-bootstrap, 不过后来更新很少，后来 greyli 基于 flask-bootstrap 开发了 bootstrap-flask 扩展模块，不经支持最新的 Bootstrap4， 还基于 Jinjia2 模板引擎的宏，做了更多的扩展。值得一提的是 greyli 是个中国帅小伙，能在文章后面的参考链接中找到他。
安装
使用 pip 安装：
pip install bootstrap-flask如果之前安装过
flask-bootstrap, 需要将其卸载掉，不然两者会有冲突，如果您遇到错误提示:jinja2.exceptions.UndefinedError: 'bootstrap' is undefined，很大可能就是这个问题
小试牛刀
导入模块
创建一个 flaskbootstrap.py 程序文件，引入模块 flask_bootstrap, 您没看错，引入的并不是 bootstrap-flask：
from flask_bootstrap import Bootstrap注意：我在做示例时，将代码文件名定义为
flask_bootstrap.py, 运行时提示 无法导入 Bootstrap 模块，这是因为文件名与模块flask_bootstrap冲突了
然后对 Flask 应用初始化：
app = Flask(__name__) # 创建一个 Flask 应用bootstrap = Bootstrap(app) # 为应用初始化 bootstrap
给应用加载 bootstrap 主要是给应用加上 Jinja2 的扩展，下面的工作就是写模板文件。
创建基础模板
bootstrap-flask 虽然基于 flask-bootstrap，但是却没有提供默认的模板文件，期望在后续版本中能有吧，不过自己写也不麻烦，我们在文件夹 templates 中创建一个 base.html，内容是：
{% from 'bootstrap/nav.html' import render_nav_item %}{% block title %} Flask Bootstrap {% endblock %} {{ bootstrap.load_css() }}{% block content %}Hello Flask Bootstrap!
{% endblock %}{% block footer %}© 2019 Python 技术{% endblock %}{{ bootstrap.load_js() }}
是不是感觉很头大，不过是代码多了些，结构很其实很简单，大部分代码是 Bootstrap 提供的基本框架代码，然后加入了一些 bootstrap-flask 的扩展。我们来分析一下：
-
首先引入导航元素宏
render_nav_item，因为在后面制作导航菜单时要用 -
然后是大段的 Bootstrap 框架代码
-
定义块，用来在继承 base.html 的子模板中做替换，其中有 标题、内容和页尾
-
动态加载 Bootstrap 样式和脚本，通过
bootstrap.load_css()和bootstrap.load_js() -
在导航菜单的位置，使用宏
render_nav_item创建一个首页菜单
这样就完成基础模板的定义，稍后会对 render_nav_item、bootstrap.load_css()和 bootstrap.load_js() 做解释。
创建页面模板
有了基础模板，就可以做具体的页面模板了，先做首页 index.html，代码如下:
{% extends "base.html" %}{% block content %}Hello Flask Bootstrap
{% endblock %}
是不是简洁多了？下面在 flaskbootstrap.py 中加上首页的视图函数:
@app.route('/')def index():return render_template('index.html')
启动
如果一切顺利，访问 localhost:5000 就能看到如下效果:
首页效果
调整浏览器页面大小，可以看到页面自适应效果，是不是很神奇。接下来详细说明一下 bootstrap-flask 模块
资源助手
在小试牛刀中，能看到对 Bootstrap 样式和脚本引用的方法 bootstrap.load_css()和 bootstrap.load_js()，默认情况下会自动从 Bootstrap 的 CDN 上引用最新版的 Bootstrap 资源，例如: https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css，这样就方便了开发者对 Bootstrap 资源的引用和升级。
使用本地资源
如果想要从其他位置或者本地引用资源，只要在给应用初始化完 Bootstrap 之后，将应用的 BOOTSTRAP_SERVE_LOCAL 属性设置为 True 就好了:
app = Flask(__name__) # 创建一个 Flask 应用bootstrap = Bootstrap(app) # 为应用初始化 bootstrapapp.config['BOOTSTRAP_SERVE_LOCAL'] = True # 设置为使用本地资源
本地资源放在 static 目录下(这个目录是 Flask 框架默认的静态资源目录)，Bootstrap 本地资源放置如下:
Bootstrap 资源
bootstrap.load_css()
加载 Bootstrap 样式资源， 参数:
-
version，指定 Bootstrap 样式版本号，默认值为 4.3.1，本地资源无效
bootstrap.load_js()
加载 Bootstrap 脚本资源
参数：
-
version，指定 Bootstrap 脚本版本号，默认为 4.3.1，本地资源无效 -
jquery_version，指定 JQuery 版本号，默认为 3.3.1，本地资源无效 -
popper_version，指定 Popper 版本号，默认为 1.14.0，本地资源无效 -
with_jquery，是否加载 JQuery， 默认为True -
with_popper，是否加载 Popper, 默认为True
宏
bootstrap-flask 主要的改进是加入了很多方法是用的宏，让对页面效果的编辑像写逻辑代码一样，并在宏中还对所处环境信息进行了判断，比如菜单是否要激活，分页控件动态效果等等，下面介绍几个典型的宏
render_nav_item()
生成一个导航菜单
参数:
-
endpoint，路径点，可以直接写视图函数名
-
text，标题
代码示例:
{% from 'bootstrap/nav.html' import render_nav_item %}
render_breadcrumb_item()
面包屑导航条 参数:
-
endpoint，路径点，可以直接写视图函数名
-
text，标题
代码示例:
{% from 'bootstrap/nav.html' import render_breadcrumb_item %}{{ render_breadcrumb_item('home', 'Home') }}{{ render_breadcrumb_item('users', 'Users') }}{{ render_breadcrumb_item('posts', 'Posts') }}{{ render_breadcrumb_item('comments', 'Comments') }}
render_static()
静态资源引用，例如引用 css 、js 或者 图标
参数:
-
type 资源类型，可以是 css 或 js 或 icon
-
filename_or_url 资源路径，文件名 或者 参数
local为False时的远程 url -
local 是否本地资源，默认为
True
代码示例:
{% from 'bootstrap/utils.html' import render_static %}{{ render_static('css', 'style.css') }}
其他宏
还有有些宏很有用，例如 表单(form)相关的，还有分页相关的，不过这些会涉及到其他 Flask 扩展模块，我们会在介绍 表单 和 数据库 的章节中做进一步学习，如果您有兴趣，可以浏览参考链接中的内容。
总结
这篇文章简单介绍了 Flask 框架中如何使用 Bootstrap 扩展，从一个简单的示例开始，讲解了基于 Jinja2 模板引擎的 bootstrap-flask 模块的使用，其中包括资源助手 bootstrap.load_css() 和 bootstrap.load_css() ，以及一些基本的宏的用法，在参考代码中有较为完整的例子，您可以作为参考。在后面的文章中将会陆续介绍 表单 和 数据库 的使用，敬请期待。