Функции формы модели ¶
Справочник по 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.См. Примеры использования сгруппированных подчиненных форм .