crispy-bulma 0.12.0

Bulma template pack for django-crispy-forms

crispy-bulma

Bulma template pack for django-crispy-forms

Documentation: https://crispy-bulma.readthedocs.io.

Requirements

Officially supported versions:

• Django: 4.2, 5.0, 5.1, 5.2

• Python 3.8, 3.9, 3.10, 3.11, 3.12, 3.13

• django-crispy-forms 2.0, 2.1, 2.2, 2.3, 2.4

• Bulma.css >= 0.9.4 (tested until 1.0.4)

Quickstart

Install this plugin using pip:

$ pip install crispy-bulma

You will need to update your project’s settings file to add crispy_forms and crispy_bulma to your projects INSTALLED_APPS. Also set bulma as and allowed template pack and as the default template pack for your project:

INSTALLED_APPS = (
    ...
    "crispy_forms",
    "crispy_bulma",
    ...
)

CRISPY_ALLOWED_TEMPLATE_PACKS = ("bulma",)

CRISPY_TEMPLATE_PACK = "bulma"

Credits

• This project is based on an archived crispy-forms-bulma fork by Discord

• The original crispy-forms-bulma project is by Jure Hotujec

• This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

Related projects

crispy-bulma’s focus is on form handling. This project assumes that you have already integrated bulma into your project, either manually or using some other package. If crispy-bulma does not meet your needs maybe one of these projects is of interest to you:

• django-bulma - an alternative way to use bulma forms. Does not use crispy forms.

• django-simple-bulma - can be used together with this project. Provides bulma integration and ads support for bulma extensions.

License

MIT license

History

0.12.0 (2025-05-11)

• Feature: add support for Fieldset. Feature contributed by DaeronAlagos.

• Add support for Bulma 1.0.0, 1.0.1, 1.0.2, 1.0.3, 1.0.4

• Add support for Django 5.1

• Add support for Django 5.2

• Add support for Python 3.13

• Add support for django-crispy-forms 2.2, 2.3, 2.4

0.11.0 (2023-12-06)

• Add support for Django 5.0

• Drop support for Django 3.2, 4.0 and 4.1

• Add support for django-crispy-forms 2.1

• BREAKING CHANGE: help text id attribute is now differently named: hint_{{ field.auto_id }} -> {{ field.auto_id }}_helptext

0.10.0 (2023-07-03)

• Drop support for Python 3.7

• Add support for Python 3.12

• Add support for Django 4.2

0.9.0 (2023-03-05)

• Drop support for django-crispy-forms 1.12.0, 1.13.0 and 1.14.0

• Add support for django-crispy-forms 2.0

• Drop support for Django 2.2

0.8.3 (2023-01-31)

• Fix Select widget error state rendering (the red border was missing).

0.8.2 (2023-01-29)

• Add support for Django 4.1

• Add support for Python 3.11

0.8.1 (2023-01-22)

• Fix DateField, DateTimeField and TimeField widget rendering

• Fix DecimalField, FloatField, IntegerField and URLField widget rendering. Fix contributed by pythonbrad.

• Fix FileUploadInput widget rendering. Fix contributed by pythonbrad.

• Fix passing attributes to IconField. Fix contributed by davy39.

0.8.0 (2022-04-28)

• Feature: add FormGroup layout object

• Fix Submit and Reset input rendering

• BREAKING CHANGE: Button is now rendered as <button></button>. For <input type="submit" /> use Submit.

• BREAKING CHANGE: Redesign IconField. Instead of IconField("envelope") call it with the full icon class e.g. IconField("fa fa-envelope").

• Drop support for Django 3.1

• Drop support for Python 3.6

0.7.0 (2022-04-17)

• Fix FormHelper.field_template attribute

• Feature: add InlineCheckboxes field

• Feature: add InlineRadios field

• Add support for django-crispy-forms 1.14.0

• Add support for Python 3.10

0.6.0 (2022-04-15)

• Add support for Django 4.0

• Fix SelectMultiple widget rendering

0.5.1 (2022-04-14)

• Readd templatetags removed by mistake.

0.5.0 (2022-04-13)

• Drop support for Django 3.0

• Upgrade crispy_forms dependency, now version >= 1.12.0 is required

0.4.0 (2022-04-13)

• Feature: add label_class helper attribute

• Feature: add support for horizontal forms

• BREAKING CHANGE: HTML in labels is now being escaped, this is consistent with django.

• BREAKING CHANGE: EmailField and EmailInput have been removed. Use django.forms.EmailField instead.

• Feature: add support for forms.MultipleChoiceField with CheckboxSelectMultiple as widget.

0.3.1 (2022-04-08)

• Fix input wrapper, replace p tag with a div

• Fix checkbox rendering, the input was rendered twice

• Initial version by ckrybus (tests, docs, packaging, no logic changes)

0.3.0 (2020-03-22) [1]

• Add support for django 3.0

0.2.0 (2019-12-12) [1]

• Update dependency pinning

0.1.2 (2019-04-02) [1]

• Add EmailInput widget

0.1.1 (2019-01-15) [1]

• Update docs

0.1.0 (2019-01-13) [1]

• Initial version by discord.

1.1.3 (2017-11-06) [2]

• Added input with icons

1.1.2 (2017-11-06) [2]

• Added template for non-field errors

• Fix radio select, which now appears inline

• Fix form actions template (submit, reset)

1.1.1 (2017-11-06) [2]

• Initial version by @jhotujec

Footnotes

[1] (1,2,3,4,5)

At that time the project was called https://github.com/python-discord/django-crispy-bulma

[2] (1,2,3)

At that time the project was called https://github.com/jhotujec/crispy-forms-bulma