flask-bootstrap安装与使用

最新推荐文章于 2025-08-01 12:35:35 发布

原创最新推荐文章于 2025-08-01 12:35:35 发布 · 5.5k 阅读

13 ·

CC 4.0 BY-SA版权

Flask 专栏收录该内容

15 篇文章

订阅专栏

本文介绍如何使用Flask-Bootstrap扩展简化Bootstrap框架在Flask应用中的集成过程，包括安装、初始化、模板继承及自定义等关键步骤。

flask-bootstrap中文手册

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

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

pip install flask-bootstrap

初始化bootstrap

from flask_bootstrap import Bootstrap
bootstrap = Bootstrap(app)

在templates下添加base.html

{%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="/">Flask</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 %}

显示效果如图：

增加一个自定义的CSS文件:

{% block styles %}
{{super()}}
<link rel="stylesheet"
      href="{{url_for('.static', filename='mystyle.css')}}">
{% endblock %}

自定义在Bootstrap的javascript代码之前加载的Javascript:

{% block scripts %}
<script src="{{url_for('.static', filename='myscripts.js')}}"></script>
{{super()}}
{% endblock %}

增加 lang="zh" 属性到 <html> 标签:

{% block html_attribs %} lang="zh"{% endblock %}

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 %}