Flask扩展: Flask-Bootstrap

来源:互联网 发布:windows swift 编译器 编辑:程序博客网 时间:2024/05/05 19:47

  • Flask-Bootstrap
    • 安装
    • 使用

Flask-Bootstrap

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

Bootstrap 是客户端框架,因此不会直接涉及服务器。服务器需要做的只是提供引用了 Bootstrap 层叠样式表(CSS)和 JavaScript 文件的 HTML 响应, 并且 HTML、CSS 和 JavaScript 代码中实例化所需组件。这些操作最理想的执行场所就是模版。

Flask-Bootstrap 可以在程序中集成 Bootstrap

安装

pip install flask-bootstrap

使用

Flask 扩展一般都在创建程序实例时初始化。

from flask_bootstrap import Bootstrap#...bootstrap = Bootstrap(app)

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

{% extends "bootstrap/base.html" %}{% block title %}Flasky{% 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 文件。

基模版中定义了可在衍生模版中重定义的块。blockendblock 指令定义的块中的内容可添加到基模版中。

上面这个示例定义了3个块,分别名为 titlenavbarcontent。这些块都是基模版提供的,可在衍生模版中重新定义。

Flask-Bootstrapbase.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-Bootstap 自用的, 如果直接重定义可能会导致一些问题。如果程序需要向已经有内容的块中添加新内容, 必须使用 Jinja2 提供的 super() 函数。例如,如果要在衍生模版中添加新的 JavaScript 文件,需要这么定义:

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