Функции формы модели ¶
Справочник по API для шаблонных форм. Вводный контент по шаблонам форм см. В руководстве по теме Создание форм из шаблонов .
modelform_factory
¶
-
modelform_factory
( модель , форма = ModelForm , fields = None , exclude = None , formfield_callback = None , widgets = None , localized_fields = None , labels = None , help_texts = None , error_messages = None , field_classes = None ) ¶ Вернуть класс
ModelForm
для данной модели. Необязательный параметр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 ) ¶ Возвращает класс
FormSet
для данного класса модели.Параметры
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 ) ¶ Возвращает один ,
InlineFormSet
используяmodelformset_factory()
значения по умолчаниюformset=
BaseInlineFormSet
,can_delete=True
иextra=3
.Если модель имеет более чем один внешний ключ ,
ForeignKey
чтобыparent_model
, вы должны заполнить параметрfk_name
.См. Примеры использования сгруппированных подчиненных форм .