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.3
Release date: 2018/7/16
- Built-in resources will be used when
FLASK_ENV
set todevelopment
. - Change CDN provider to jsDelivr.
1.0.2
Release date: 2018/7/21
- Include
popper.js
beforebootstrap.js
inbootstrap.load_js()
. (#2)
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).
Project 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
File details
Details for the file Bootstrap-Flask-1.0.3.tar.gz
.
File metadata
- Download URL: Bootstrap-Flask-1.0.3.tar.gz
- Upload date:
- Size: 750.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 84a07f8d64e531ae4ec40beb3e1426547225e28fbe30ea4ef3f40a64eafadfde |
|
MD5 | 218692b57ff82773c832773dae6a7594 |
|
BLAKE2b-256 | 2d1cb16c5ef7b6a75cadfff880a8d80ef91052f4f72c64fba948e782bde03d2e |
File details
Details for the file Bootstrap_Flask-1.0.3-py2.py3-none-any.whl
.
File metadata
- Download URL: Bootstrap_Flask-1.0.3-py2.py3-none-any.whl
- Upload date:
- Size: 767.4 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 873866bf766cc9923e331534e1d09225f0a915ff19fff5cd932c09521ffd659d |
|
MD5 | 3b970694061fbaea6175f6cbfad42601 |
|
BLAKE2b-256 | b015aaee11e6e829c2aa9a0eaf0182e149ca86c40c45ad3c6c38b4dd64dd5ab8 |