Welcome | Get started | Dive | Contribute | Topics | Reference | Changes | More

Chooser examples

Introduction to Combo boxes

Examples in this document use the lino_book.projects.chooser demo project.

>>> from lino import startup
>>> startup('lino_book.projects.chooser.settings')
>>> from lino.api.doctest import *
>>> be = chooser.Country.objects.get(name="Belgium")
>>> fr = chooser.Country.objects.get(name="France")

You instantiate a chooser by specifying a model and a fieldname. The fieldname must be the name of a field that has been defined in your model.

A chooser for a field FOO will look whether the model defines a class method FOO_choices.

Choosers on ForeignKey fields

A Contact has ForeignKey fields to Country and City. In an entry form for a Contact you want only the cities of that country when selecting a city.

How to use a Chooser on a ForeignKey:

>>> from lino.core.utils import get_field
>>> city = chooser.Contact.get_chooser_for_field('city')
>>> [str(o) for o in city.get_choices(country=be)]
['Brussels', 'Eupen', 'Gent']
>>> [str(o) for o in city.get_choices(country=fr)]
['Bordeaux', 'Paris']
>>> [str(o) for o in city.get_choices()]
['Bordeaux', 'Brussels', 'Eupen', 'Gent', 'Narva', 'Paris', 'Tallinn', 'Tartu']

There is no method country_choices, so Contact.country has no Chooser:

>>> print(chooser.Contact.get_chooser_for_field('country'))

Char field choosers

How to make and use a chooser on a char-field, to limit the valid values:

from django.db import models
from lino.api import dd, _

    ('FR', 'Freshman'),
    ('SO', 'Sophomore'),
    ('JR', 'Junior'),
    ('SR', 'Senior'),
    ('GR', 'Graduate'),

MENU = [
    # name reserved_for
    ('Potato', None),
    ('Vegetable', 'SO JR SR GR'),
    ('Meat', 'JR SR GR'),
    ('Fish', 'SR GR'),

year_in_school = models.CharField(max_length=2,
food = models.CharField(max_length=20, blank=True)

def food_choices(cls, year_in_school):
    food = []
    for name, reserved_for in MENU:
        if (year_in_school
                is None) or (reserved_for
                             is None) or year_in_school in reserved_for:
    return food
>>> food = chooser.Contact.get_chooser_for_field('food')
>>> [str(o) for o in food.get_choices()]
['Potato', 'Vegetable', 'Meat', 'Fish']
>>> [str(o) for o in food.get_choices(year_in_school='FR')]
>>> [str(o) for o in food.get_choices(year_in_school='SO')]
['Potato', 'Vegetable']

Special cases

Note that get_choices() ignores any unused keyword arguments:

>>> [str(o) for o in city.get_choices(country=be, foo=1, bar=True, baz='7')]
['Brussels', 'Eupen', 'Gent']

Choosers on a ChoiceListField

Examples of choosers on a ChoiceListField are

See also