A Django app that provides enhanced form rendering with Bootstrap styles.
Project description
Django Bootstrap Forms is a Django app that provides enhanced form rendering with Bootstrap styles.
Installation
Install the package using pip:
pip install nvs-bootstrap-forms
Add ‘bootstrap_forms’ to your INSTALLED_APPS in the Django settings:
INSTALLED_APPS = [ # ... 'bootstrap_forms', # ... ]
Include Bootstraps css and js links in your html:
<!doctype html> <html lang=
"en"> <head> <!-- Your headers goes here --> <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css"rel="stylesheet"> </head> <body> <!-- Your content goes here --> <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js"></script> </body> </html>
Usage
Load Bootstrap Forms in your template:
{% load bootstrap_forms_tags %}
Use the `bootstrap_form` template tag to render your form:
<form method=
"post"> {% csrf_token %} {% bootstrap_form form %} <button type="submit">Submit</button> </form>This will render the form with Bootstrap styles.
Customization:
You can customize the rendering of individual fields by using the field_order and other attributes in your form fields.
For advanced customization, you can extend the provided BootstrapFormRendererNode class in the bootstrap_forms.templatetags.bootstrap_forms_tags module.
Contributing
Feel free to contribute by opening issues or submitting pull requests. Please read the Contributing Guidelines for more details.
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
Hashes for nvs_bootstrap_forms-0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 118f71ac221d1cc823d725c6b25ada860c1b5e73890190244100c54594439d6b |
|
MD5 | 0e96221a7353a3b620d2aca81e885400 |
|
BLAKE2b-256 | 4dd76841cdbdd3a6db9526ee1b65097b13af16ae10e40e28635f0609cb2fabc5 |