django.forms.models.ModelChoiceField

class documentation

class ModelChoiceField(ChoiceField): (source)

Known subclasses: django.forms.models.ModelMultipleChoiceField

A ChoiceField whose choices are a model QuerySet.

Method	`__deepcopy__`	Undocumented
Method	`__init__`	Undocumented
Method	`get_limit_choices_to`	Return ``limit_choices_to`` for this form field.
Method	`has_changed`	Return True if data differs from initial.
Method	`label_from_instance`	Convert objects into strings and generate the labels for the choices presented by this object. Subclasses can override this method to customize the display of the choices.
Method	`prepare_value`	Undocumented
Method	`to_python`	Return a string.
Method	`validate`	Validate that the input is in self.choices.
Class Variable	`choices`	Undocumented
Class Variable	`default_error_messages`	Undocumented
Instance Variable	`empty_label`	Undocumented
Instance Variable	`limit_choices_to`	Undocumented
Instance Variable	`queryset`	Undocumented
Instance Variable	`to_field_name`	Undocumented
Method	`_get_choices`	Undocumented
Method	`_get_queryset`	Undocumented
Method	`_set_queryset`	Undocumented
Instance Variable	`_queryset`	Undocumented

Inherited from ChoiceField:

Method	`valid_value`	Check to see if the provided value is a valid choice.
Method	`_set_choices`	Undocumented
Instance Variable	`_choices`	Undocumented

Inherited from Field (via ChoiceField):

Method	`bound_data`	Return the value that should be shown for this field on render of a bound form, given the submitted POST data for the field and the initial data, if any.
Method	`clean`	Validate the given value and return its "cleaned" value as an appropriate Python object. Raise ValidationError for any errors.
Method	`get_bound_field`	Return a BoundField instance that will be used when accessing the form field in a template.
Method	`run_validators`	Undocumented
Method	`widget_attrs`	Given a Widget instance (not a Widget class), return a dictionary of any HTML attributes that should be added to the Widget, based on this Field.
Class Variable	`default_validators`	Undocumented
Class Variable	`empty_values`	Undocumented
Instance Variable	`disabled`	Undocumented
Instance Variable	`error_messages`	Undocumented
Instance Variable	`help_text`	Undocumented
Instance Variable	`initial`	Undocumented
Instance Variable	`label`	Undocumented
Instance Variable	`label_suffix`	Undocumented
Instance Variable	`localize`	Undocumented
Instance Variable	`required`	Undocumented
Instance Variable	`show_hidden_initial`	Undocumented
Instance Variable	`validators`	Undocumented
Instance Variable	`widget`	Undocumented

def __deepcopy__(self, memo): (source) ¶

overrides django.forms.fields.ChoiceField.__deepcopy__

Undocumented

def __init__(self, queryset, *, empty_label='---------', required=True, widget=None, label=None, initial=None, help_text='', to_field_name=None, limit_choices_to=None, blank=False, **kwargs): (source) ¶

overrides django.forms.fields.ChoiceField.__init__

overridden in django.forms.models.ModelMultipleChoiceField

Undocumented

def get_limit_choices_to(self): (source) ¶

Return ``limit_choices_to`` for this form field. If it is a callable, invoke it and return the result.

def has_changed(self, initial, data): (source) ¶

overrides django.forms.fields.Field.has_changed

overridden in django.forms.models.ModelMultipleChoiceField

Return True if data differs from initial.

def label_from_instance(self, obj): (source) ¶

Convert objects into strings and generate the labels for the choices presented by this object. Subclasses can override this method to customize the display of the choices.

def prepare_value(self, value): (source) ¶

overrides django.forms.fields.Field.prepare_value

overridden in django.forms.models.ModelMultipleChoiceField

Undocumented

def to_python(self, value): (source) ¶

overrides django.forms.fields.ChoiceField.to_python

overridden in django.forms.models.ModelMultipleChoiceField

Return a string.

def validate(self, value): (source) ¶

overrides django.forms.fields.ChoiceField.validate

Validate that the input is in self.choices.

choices = (source) ¶