Bootstrap helper for Flask/Jinja2.
Project description
Bootstrap-Flask
Bootstrap 4 helper for Flask/Jinja2. Based on Flask-Bootstrap, but lighter and better.
Installation
$ pip install bootstrap-flask
Initialization
from flask_bootstrap import Bootstrap
from flask import Flask
app = Flask(__name__)
bootstrap = Bootstrap(app)
Resources helpers
When development, Bootstrap-Flask provides two helper functions that can be used to generate
resources load code in template: bootstrap.load_css() and bootstrap.load_js()
Call it at your template, for example:
<head>
{{ bootstrap.load_css() }}
</head>
<body>
...
{{ bootstrap.load_js() }}
</body>
Macros
| Macro | Templates Path | Description |
|---|---|---|
| render_field() | bootstrap/form.html | Redner a WTForms form field |
| render_form() | bootstrap/form.html | Render a WTForms form |
| render_pager() | bootstrap/pagination.html | Render a basic pagination, only include previous and next button. |
| render_pagination() | bootstrap/pagination.html | Render a standard pagination |
| render_nav_item() | bootstrap/nav.html | Render a navigation item |
| render_breadcrumb_item() | bootstrap/nav.html | Render a breadcrumb item |
| render_static() | bootstrap/utils.html | Render a resource reference code (i.e. <link>, <script>) |
How to use these macors? It's quite simple, just import them from the correspond path and then call them like any other macro:
{% from 'bootstrap/form.html' import render_form %}
{{ render_form(form) }}
API documentation will coming soon...
Run the demo application
$ git clone https://github.com/greyli/bootstrap-flask.git
$ pip install flask flask-wtf flask-sqlalchemy bootstrap-flask
$ cd bootstrap-flask/examples
$ flask run
Now go to http://localhost:5000.
Changelog
1.0.1
Release date: 2018/7/1
- Fix local resources path error
- Add basic unit tests
1.0
Release date: 2018/6/11
Initialize release.
License
This project is licensed under the MIT License (see the
LICENSE file for details).
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for Bootstrap_Flask-1.0.1-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 806026f42429413e2b0bdec4c8a34c390dffc5561946fe7eadc1f086e666d9de |
|
| MD5 | 044a3a519db1f6298b6ca1b2d8a3c375 |
|
| BLAKE2b-256 | f6fa5ee5e0bd8df335ab3759aaea2acc7ef5a68387126cce6e50689e677622c1 |
