Easy way to customize Django Forms

A quick and simple overview to Bootstrap and style your Django forms.

I had to go through this recently. I read many threads and comments around asking the same questions, so I guess a simple thread wouldn't be bad for anyone who just starts using Django.

1. Install django-widget-tweaks and Bootstrap.

You can install it through pip:

$ pip install django-widget-tweaks

2. Import Bootstrap and django-widget-tweaks.

Open the settings.py of your Django project, find INSTALLED_APPS and insert widget_tweaks there.

To import Bootstrap, just visit the official page, click Get Started and copy the stylesheet <link> into your <head> of your base.html which is used for template extending in Django.

3. Load widget_tweaks to your template.

Insert {% load widget_tweaks %} to your template.

4. Use render_field template tag

A render_field template tag provides the ability to customize any form field easily with HTML attributes and CSS classes. The complete list of features appear on the official repository of the package

{% render_field form.username class="form-control" placeholder="Username" %}
    ...
    ...
{% render_field form.password2 class="form-control" id="PassConf" placeholder="Confirm Password" %}

5 Some CSS to style your forms as you please.

.form-control{
    border: 1px solid rgba(65, 65, 65, 0.91);
    box-shadow: 0 0 0 0.15rem rgba(0, 0, 0, 0.25);
}
.form-control:hover {
    border: 1px solid rgb(184, 69, 241);
    box-shadow: 0 0 0 0.25rem rgba(192, 112, 246, 0.64);
}

.form-control:focus {
    border: 1px solid rgb(0, 127, 244, 1);
    box-shadow: 0 0 0 0.25rem rgb(0, 127, 244, 0.45);
}

#PassConf {
    border: 1px solid rgb(92, 241, 69);
    box-shadow: 0 0 0 0.2rem rgba(112, 246, 166, 0.64);
}

Source code and all the customization options: https://github.com/jazzband/django-widget-tweaks/

Blog

Easy way to customize Django Forms

tdvr

Join Our Newsletter. No Spam, Only the good stuff.

Related