Class MultiValueField
Aggregate the logic of multiple Fields.
Declaration
class MultiValueField(
Field)
source linkDocumentation
Its clean() method takes a "decompressed" list of values, which are then
cleaned into a single value according to self.fields. Each value in
this list is cleaned by the corresponding field -- the first value is
cleaned by the first field, the second value is cleaned by the second
field, etc. Once all fields are cleaned, the list of clean values is
"compressed" into a single value.
Subclasses should not have to implement clean(). Instead, they must
implement compress(), which takes a list of valid values and returns a
"compressed" version of those values -- a single value.
You'll probably want to use this with MultiWidget.
Methods
▶ def __init__(self, fields, *, require_all_fields=True, **kwargs) override ▶ def clean(self, value) override Validate every value in the given list. A value is validated against the corresponding Field in self.fields.
This method overrides django.forms.fields.Field.clean.
For example, if this MultiValueField was instantiated with
fields=(DateField(), TimeField()), clean() would call
DateField.clean(value[0]) and TimeField.clean(value[1]).
▶ def compress(self, data_list) Return a single value for the given list of values. The values can be assumed to be valid.
For example, if this MultiValueField was instantiated with
fields=(DateField(), TimeField()), this might return a datetime
object created by combining the date and time in data_list.
Overrides
This method is overriden in:
▶ def has_changed(self, initial, data) overrideinherited doc Return True if data differs from initial.
Inherited methods
Subclasses