Skip to main content

Django inline formsets with bootstrap

Project description

mizdb-inlines

Django inline formsets with bootstrap for the MIZDB app.

Requires django_bootstrap5.

Formsets will be rendered in a layout with two columns. One column is for the formset form, and the other column is for the delete button of a given formset form.

Installation

Install using pip:

pip install mizdb-inlines

Add to your INSTALLED_APPS in your settings.py:

INSTALLED_APPS = [
    ...,
    "mizdb_inlines",
]

Usage

Add mizdb_inlines/js/mizdb_inlines.js javascript and render the formset using the inline_formset template tag from the mizdb_inlines template tag library:

<!DOCTYPE html>
{% load static mizdb_inlines django_bootstrap5 %}
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>My Awesome Form</title>
    {{ form.media }}
    {{ formset.media }}
    <script src="{% static 'mizdb_inlines/js/mizdb_inlines.js' %}"></script>
    {% bootstrap_css %}
    {% bootstrap_javascript %}
</head>
<body>
<form class="container mt-3" method="post">
    {% csrf_token %}

    {% bootstrap_form form %}
    {% inline_formset formset layout="horizontal" %}
    {% bootstrap_button button_type="submit" button_class="success" content="Save" %}
    {% bootstrap_button button_type="reset" button_class="warning" content="Reset" %}
</form>
</body>
</html>

View mixin for inline formsets

Use the InlineFormsetMixin view mixin to remove some of the boilerplate from handling inline formsets. Simply declare the formset classes to use in the formset_classes attribute.

from mizdb_inlines.views import InlineFormsetMixin


class MyView(InlineFormsetMixin, UpdateView):
    model = Pizza
    fields = "__all__"
    template_name = "pizza.html"
    success_url = "/"

    formset_classes = (
        inlineformset_factory(Pizza, Toppings, fields="__all__", extra=1),
        MyAwesomeFormset,
    )

This will add formset instances to the template context with the context variable formsets. The combined media of the formsets is available with the variable formset_media :

{{ formset_media }}

{% for formset in formsets %}
    {% inline_formset formset %}
{% endfor %}

Development & Demo

python3 -m venv venv
source venv/bin/activate
make init

See the demo for a preview: run make init-demo and then start the demo server python demo/manage.py runserver.

Run tests with make test. To install required browsers for playwright: playwright install.

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

mizdb-inlines-0.2.2.tar.gz (12.4 kB view details)

Uploaded Source

Built Distribution

mizdb_inlines-0.2.2-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file mizdb-inlines-0.2.2.tar.gz.

File metadata

  • Download URL: mizdb-inlines-0.2.2.tar.gz
  • Upload date:
  • Size: 12.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for mizdb-inlines-0.2.2.tar.gz
Algorithm Hash digest
SHA256 221541f5e7ff342dd65d70d064a0c912cece5802fb474e1df226de1b33a174b5
MD5 c4f32331443be3a2e5751cedd3fe1c0d
BLAKE2b-256 fd8e932f1f7784121f133263bac1aae79eb9adacb62d434cb1e1b32a0643af6b

See more details on using hashes here.

File details

Details for the file mizdb_inlines-0.2.2-py3-none-any.whl.

File metadata

File hashes

Hashes for mizdb_inlines-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 dc799b26798a6f021b029800703fc80949191d6dbab9ef37a6906e0097ef365b
MD5 7e91924d3fbdb982c0a9207eed51af85
BLAKE2b-256 f4542e7cb14f80aa2ea87e5b7482cd0fd39e655c90e5200c5f03ad22b2a1c605

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