Функции формы модели

Справочник API формы модели. Для вводной информации о формах модели см. руководство по теме Создание форм из моделей.

modelform_factory

modelform_factory(model, form=ModelForm, fields=None, exclude=None, formfield_callback=None, widgets=None, localized_fields=None, labels=None, help_texts=None, error_messages=None, field_classes=None) [source]

Возвращает класс ModelForm для заданной model. Вы можете необязательно передать аргумент form в качестве начальной точки для построения ModelForm.

fields — это необязательный список имён полей. Если он указан, то в возвращаемые поля будут включены только указанные поля.

exclude — это необязательный список имён полей. Если он указан, то указанные поля будут исключены из возвращаемых полей, даже если они указаны в аргументе fields.

formfield_callback — это вызываемый объект, который принимает поле модели и возвращает поле формы.

widgets — это словарь, сопоставляющий имена полей модели с виджетом.

localized_fields — это список имён полей, которые следует локализовать.

labels — это словарь, сопоставляющий имена полей модели с меткой.

help_texts — это словарь, сопоставляющий имена полей модели с текстом справки.

error_messages — это словарь, сопоставляющий имена полей модели со словарем сообщений об ошибках.

field_classes — это словарь, сопоставляющий имена полей модели с классом поля формы.

См. Функцию-фабрику ModelForm для примера использования.

Вы должны явно указать список полей, либо через ключевые аргументы fields или exclude, либо через соответствующие атрибуты во внутреннем классе Meta формы. См. Выбор используемых полей для получения дополнительной информации. Пропуск любого определения используемых полей приведёт к исключению ImproperlyConfigured.

modelformset_factory

modelformset_factory(model, form=ModelForm, formfield_callback=None, formset=BaseModelFormSet, extra=1, can_delete=False, can_order=False, max_num=None, fields=None, exclude=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None) [source]

Возвращает класс FormSet для заданного класса model.

Аргументы model, form, fields, exclude, formfield_callback, widgets, localized_fields, labels, help_texts, error_messages, и field_classes передаются в modelform_factory().

Аргументы formset, extra, max_num, can_order, can_delete и validate_max передаются в formset_factory(). См. наборы форм для получения подробностей.

См. Наборы форм моделей для примера использования.

inlineformset_factory

inlineformset_factory(parent_model, model, form=ModelForm, formset=BaseInlineFormSet, fk_name=None, fields=None, exclude=None, extra=3, can_order=False, can_delete=True, max_num=None, formfield_callback=None, widgets=None, validate_max=False, localized_fields=None, labels=None, help_texts=None, error_messages=None, min_num=None, validate_min=False, field_classes=None) [source]

Возвращает набор форм InlineFormSet с использованием modelformset_factory() с значениями по умолчанию formset=BaseInlineFormSet, can_delete=True, и extra=3.

Если ваша модель имеет более одного ForeignKey к parent_model, вы должны указать fk_name.

См. Встроенные наборы форм для примера использования.