forms.TypedChoiceField

class TypedChoiceField(**kwargs) [source]

Just like a ChoiceField, except TypedChoiceField takes two extra arguments, coerce and empty_value.

• Default widget: Select
• Empty value: Whatever you’ve given as empty_value.
• Normalizes to: A value of the type provided by the coerce argument.
• Validates that the given value exists in the list of choices and can be coerced.
• Error message keys: required, invalid_choice

Takes extra arguments:

coerce

A function that takes one argument and returns a coerced value. Examples include the built-in int, float, bool and other types. Defaults to an identity function. Note that coercion happens after input validation, so it is possible to coerce to a value not present in choices.

empty_value

The value to use to represent “empty.” Defaults to the empty string; None is another common choice here. Note that this value will not be coerced by the function given in the coerce argument, so choose it accordingly.