Skip to main content

A Django app that provides enhanced form rendering with Bootstrap styles.

Project description

Latest Version Downloads License

Django Bootstrap Forms is a Django app that provides enhanced form rendering with Bootstrap styles.

Installation

  1. Install the package using pip:

    pip install nvs-bootstrap-forms
  2. Add ‘bootstrap_forms’ to your INSTALLED_APPS in the Django settings:

    INSTALLED_APPS = [
        # ...
        'bootstrap_forms',
        # ...
    ]
  3. 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

  1. Load Bootstrap Forms in your template:

    {% load bootstrap_forms_tags %}
  2. 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.

  3. 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

This version

0.1

Download files

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

Source Distribution

nvs-bootstrap-forms-0.1.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nvs_bootstrap_forms-0.1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file nvs-bootstrap-forms-0.1.tar.gz.

File metadata

  • Download URL: nvs-bootstrap-forms-0.1.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.1

File hashes

Hashes for nvs-bootstrap-forms-0.1.tar.gz
Algorithm Hash digest
SHA256 d63943635ff2b5433f7c9a2f43b7d7c1e357fbc3dfb372b24459b7948b89b15a
MD5 15ec91ac2adf87d8fbb57c476973f2bb
BLAKE2b-256 71808632e0683f8fca66e5c91ee4fa26f1212340f8e9276c997e04dead5ba3de

See more details on using hashes here.

File details

Details for the file nvs_bootstrap_forms-0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for nvs_bootstrap_forms-0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 118f71ac221d1cc823d725c6b25ada860c1b5e73890190244100c54594439d6b
MD5 0e96221a7353a3b620d2aca81e885400
BLAKE2b-256 4dd76841cdbdd3a6db9526ee1b65097b13af16ae10e40e28635f0609cb2fabc5

See more details on using hashes here.

Supported by

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