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

Справочник по 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 .

См. Примеры использования сгруппированных подчиненных форм .

Copyright ©2021 All rights reserved