django-bootstrap-input-group 1.0.1

Render Django form fields as bootstrap input groups.

django-bootstrap-input-group

This is an add-on for django-bootstrap5 for rendering multiple django form fields as a Bootstrap input group.

Requirements

Django 3.2 or newer and django-bootstrap5.

Installation

1. Install using pip:

   pip install django-bootstrap-input-group
   

2. Add to INSTALLED_APPS in your settings.py:

   INSTALLED_APPS = [
       # ...
       "django_bootstrap_input_group"
       # ...
    ]
   

Preview

Check out the little demo:

git clone https://github.com/Actionb/django-bootstrap-input-group.git
cd django-bootstrap-input-group/demo
pip install -r requirements.txt
python manage.py runserver

Then visit the demo forms on http://127.0.0.1:8000/.

Usage

In your templates, load the template tag set django_bootstrap_input_group. Then you can render an input group of fields either by:

• declaring the groups in a field_groups attribute on your form and using the bootstrap_grouped_form template tag to render that form
• using the bootstrap_input_group template tag to render a single group

Using field_groups form attribute:

Declare field_groups on your form:

from django import forms


class ContactForm(forms.Form):
    first_name = forms.CharField()
    last_name = forms.CharField()
    notes = forms.CharField()
    
    field_groups = [('Name', ('first_name', 'last_name')), 'notes']

Then in your templates:

{% load django_bootstrap_input_group %}

{# Load CSS and JavaScript #}
{% bootstrap_css %}
{% bootstrap_javascript %}

<form>
    {# Render a form as a grouped form #}
    {% bootstrap_grouped_form form %}
    
    {# Or for formsets #}
    {% bootstrap_grouped_formset formset %}
</form>

field_groups contains the names of form fields in the order that they should be rendered in, with nested lists (or tuples) of names representing a group. The nested list can be either a flat list, or a two-item list, where the first item is the label for the group and the second is the list of field names:

# No groups - just field names:
field_groups = ['first_name', 'last_name', 'notes']

# first_name and last_name make up a group, but no group label is specified:
field_groups = [('first_name', 'last_name'), 'notes']

# first_name and last_name make up a group, with the group label "Name":
field_groups = [('Name', ('first_name', 'last_name')), 'notes']

If no label is provided, the label of the first field in a group is used as the label for the group.

Using the input group template tag:

Or you can just render a group of fields directly, using the bootstrap_input_group template tag:

{% load django_bootstrap5 django_bootstrap_input_group %}

<form>
    {% bootstrap_input_group form.first_name form.last_name label="Name" %}
    {% bootstrap_field form.notes %}
</form>

Template tag arguments

The bootstrap_input_group tag takes (bound) form fields as positional arguments. It also takes an optional keyword argument label which specifies the label for the group (if no label is provided, it defaults to the label of the first field in a group).
Other than that, the django_bootstrap_input_group template tags take the same arguments as their django_bootstrap5 counterparts (see here for a list of the template tags and their parameters).

CSS

This package ships with an additional css file django_bootstrap_input_group/css/bootstrap_input_group.css which includes rules that tweak the look of RadioSelectButtonGroup widgets when rendered inside an input group. The rules:

• vertically align the label text of the options
• remove rounded corners of label elements (where necessary)

Simply include the css file in your form's media (also: How to manage static files).