Django Bootstrap Forms is a Django app that provides enhanced form rendering with Bootstrap styles.
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>
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.
Feel free to contribute by opening issues or submitting pull requests. Please read the Contributing Guidelines for more details.
This project is licensed under the MIT License - see the LICENSE file for details.