Skip to content

django FormFields using the Chosen javascript plugin for jQuery

License

Notifications You must be signed in to change notification settings

rfleschenberg/django-chosen

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

34 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

django-chosen

django-chosen is a project that makes available django FormFields that uses the Chosen javascript plugin. It was created by developers at The Atlantic.

Installation

The recommended way to install from source is with pip:

    $ pip install -e git+git://github.com/theatlantic/django-chosen.git#egg=django-chosen

If the source is already checked out, use setuptools:

    $ python setup.py install

Usage

django-chosen makes the following fields and widget available:

Fields:

  • ChosenChoiceField
  • ChosenModelChoiceField
  • ChosenMultipleChoiceField
  • ChosenModelMultipleChoiceField

Widgets:

  • ChosenSelect
  • ChosenSelectMultiple

The django-chosen fields can be passed an optional kwarg overlay that overrides the text which appears when no option is selected in the dropdown.

Example

from django import forms
from chosen import forms as chosenforms

class BookForm(forms.Form):
    name = forms.CharField(max_length=100)
    quality = chosenforms.ChosenChoiceField(overlay="Select book quality...",
        choices=(('New', 'new'), ('Used', 'used')))
    authors = chosenforms.ChosenModelMultipleChoiceField(queryset=Author.objects.all())

License

The django code is licensed under the [Simplified BSD License](Simplified BSD License) and is copyright The Atlantic Media Company. View the LICENSE file under the root directory for complete license and copyright information.

The Chosen javascript library included is licensed under the MIT License. View chosen/media/js/chosen.LICENSE.md for complete license and copyright information about the Chosen javascript library.

Chosen Javascript Documentation

Chosen is a library for making long, unwieldy select boxes more user friendly.

  • jQuery support: 1.4+
  • Prototype support: 1.7+

For documentation, usage, and examples, see Harvest's Chosen JS github

Chosen Javascript Credits

About

django FormFields using the Chosen javascript plugin for jQuery

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 89.6%
  • Python 10.4%