django-dropulous

Django form widgets for Dropulous - dependency-free customisable dropdown controls.

See a live example.

Features

• DropulousWidget and DropulousMultipleWidget - widgets to use with a model form
• DropulousChoiceField and DropulousMultipleChoiceField - form fields to use in standard forms
• AutocompleteView and ModelAutocompleteView - API views to serve dropdown options

Django-Dropulous does not support Dropulous on <input> fields, or its can-add option. For that, you'll want to use django-tagulous - it has a SingleTagField to allow custom choices on ForeignKey relationships, and a TagField for a full tagging system on ManyToMany relationships, with proper tag parsing, tree-based tags, and more.

Quick start

pip install django-dropulous

# settings.py
INSTALLED_APPS = [
    ...
    "django_dropulous",
]

# forms.py
from django_dropulous.widgets import DropulousWidget, DropulousMultipleWidget


class BookForm(forms.ModelForm):
    class Meta:
        model = Book
        fields = ["genre", "authors"]
        widgets = {
            "genre": DropulousWidget(),
            "authors": DropulousMultipleWidget(source="/autocomplete/authors/"),
        }

Read the full documentation or find the project on PyPI.