Skip to main content

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 to development.
  • Change CDN provider to jsDelivr.

1.0.2

Release date: 2018/7/21

  • Include popper.js before bootstrap.js in bootstrap.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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Bootstrap-Flask-1.0.3.tar.gz (750.9 kB view details)

Uploaded Source

Built Distribution

Bootstrap_Flask-1.0.3-py2.py3-none-any.whl (767.4 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file Bootstrap-Flask-1.0.3.tar.gz.

File metadata

File hashes

Hashes for Bootstrap-Flask-1.0.3.tar.gz
Algorithm Hash digest
SHA256 84a07f8d64e531ae4ec40beb3e1426547225e28fbe30ea4ef3f40a64eafadfde
MD5 218692b57ff82773c832773dae6a7594
BLAKE2b-256 2d1cb16c5ef7b6a75cadfff880a8d80ef91052f4f72c64fba948e782bde03d2e

See more details on using hashes here.

File details

Details for the file Bootstrap_Flask-1.0.3-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for Bootstrap_Flask-1.0.3-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 873866bf766cc9923e331534e1d09225f0a915ff19fff5cd932c09521ffd659d
MD5 3b970694061fbaea6175f6cbfad42601
BLAKE2b-256 b015aaee11e6e829c2aa9a0eaf0182e149ca86c40c45ad3c6c38b4dd64dd5ab8

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page