{"title":"Foirmeacha múnla","version":"5.2","locale":"ga","docname":"ref/forms/models","url":"/ga/5.2/ref/forms/models/","canonical":"https://djangodocs.dev/ga/5.2/ref/forms/models/","summary":"ModelForm API reference. For introductory material about using a ModelForm, see the Foirmeacha a chruthú ó shamhl topic guide.","html":"

Foirmeacha múnlaLink to this heading#

\n

ModelForm API reference. For introductory material about using a\nModelForm, see the Foirmeacha a chruthú ó shamhl topic guide.

\n
\n

Model form Meta APILink to this heading#

\n
\n
\nclass ModelFormOptionsLink to this definition#
\n
\n\n

The _meta API is used to build forms that reflect a Django model. It is\naccessible through the _meta attribute of each model form, and is an\ndjango.forms.models.ModelFormOptions instance.

\n

The structure of the generated form can be customized by defining metadata\noptions as attributes of an inner Meta class. For example:

\n
Code
from django.forms import ModelForm\nfrom myapp.models import Book\n\n\nclass BookForm(ModelForm):\n    class Meta:\n        model = Book\n        fields = ["title", "author"]\n        help_texts = {\n            "title": "The title of the book",\n            "author": "The author of the book",\n        }\n        # ... other attributes\n
\n

Required attributes are model, and either\nfields or exclude. All\nother Meta attributes are optional.

\n

Optional attributes, other than localized_fields and\nformfield_callback, expect a dictionary that maps a\nmodel field name to a value. Any field that is not defined in the dictionary\nfalls back to the field's default value.

\n\n\n
\n

teachtaireachtaí earráidLink to this heading#

\n
\n
\nModelFormOptions.error_messagesLink to this definition#
\n

A dictionary that maps a model field name to a dictionary of error message\nkeys (null, blank, invalid, unique, etc.) mapped to custom\nerror messages.

\n

When a field is not specified, Django will fall back on the error messages\ndefined in that model field's django.db.models.Field.error_messages\nand then finally on the default error messages for that field type.

\n
\n\n
\n
\n

excludeLink to this heading#

\n
\n
\nModelFormOptions.excludeLink to this definition#
\n

A tuple or list of model field names to be\nexcluded from the form.

\n

Either fields or\nexclude must be set. If neither are set, an\nImproperlyConfigured exception will be\nraised. If exclude is set and\nfields is unset, all model fields, except for\nthose specified in exclude, are included in the\nform.

\n
\n\n
\n
\n

field_classesLink to this heading#

\n
\n
\nModelFormOptions.field_classesLink to this definition#
\n

A dictionary that maps a model field name to a Field\nclass, which overrides the form_class used in the model field's\nField.formfield() method.

\n

When a field is not specified, Django will fall back on the model field's\ndefault field class.

\n
\n\n
\n
\n

``réimsí ``Link to this heading#

\n
\n
\nModelFormOptions.fieldsLink to this definition#
\n

A tuple or list of model field names to be\nincluded in the form. The value '__all__' can be used to specify that\nall fields should be included.

\n

If any field is specified in exclude, this will\nnot be included in the form despite being specified in\nfields.

\n

Either fields or\nexclude must be set. If neither are set, an\nImproperlyConfigured exception will be\nraised.

\n
\n\n
\n
\n

formfield_callbackLink to this heading#

\n
\n
\nModelFormOptions.formfield_callbackLink to this definition#
\n

A function or callable that takes a model field and returns a\ndjango.forms.Field object.

\n
\n\n
\n
\n

help_textsLink to this heading#

\n
\n
\nModelFormOptions.help_textsLink to this definition#
\n

A dictionary that maps a model field name to a help text string.

\n

When a field is not specified, Django will fall back on that model field's\nhelp_text.

\n
\n\n
\n
\n

labelsLink to this heading#

\n
\n
\nModelFormOptions.labelsLink to this definition#
\n

A dictionary that maps a model field names to a label string.

\n

When a field is not specified, Django will fall back on that model field's\nverbose_name and then the field's attribute\nname.

\n
\n\n
\n
\n

localized_fieldsLink to this heading#

\n
\n
\nModelFormOptions.localized_fieldsLink to this definition#
\n

A tuple or list of model field names to be\nlocalized. The value '__all__' can be used to specify that all fields\nshould be localized.

\n

By default, form fields are not localized, see\nenabling localization of fields for more details.

\n
\n\n
\n
\n

``Samhail ``Link to this heading#

\n
\n
\nModelFormOptions.modelLink to this definition#
\n

Required. The django.db.models.Model to be used for the\nModelForm.

\n
\n\n
\n
\n

widgetsLink to this heading#

\n
\n
\nModelFormOptions.widgetsLink to this definition#
\n

A dictionary that maps a model field name to a\ndjango.forms.Widget.

\n

When a field is not specified, Django will fall back on the default widget\nfor that particular type of django.db.models.Field.

\n
\n\n
\n
\n
\n

Model form factory functionsLink to this heading#

\n
\n

modelform_factoryLink to this heading#

\n
\n
\nmodelform_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)Link to this definition#
\n

Tuairisceáin a:class: ~django.forms.ModelForm aicme don model tugtha. Is féidir leat argóint foirm ``a rith go roghnach le húsáid mar phointe tosaigh chun an `ModelForm a thógáil.

\n

Is liosta roghnach d'ainmneacha réimse é fields. Má chuirtear ar fáil, ní chuirfear ach na réimsí ainmnithe san áireamh sna réimsí ar ais.

\n

Is liosta roghnach d'ainmneacha réimse é eisiúint. Má chuirtear ar fáil, cuirfear na réimsí ainmnithe a eisiamh ó na réimsí a cuireadh ar ais, fiú má tá siad liostaithe san argóint ``réimsí ``.

\n

Is inghlaoch é formfield_callback a ghlacann réimse samhail agus a thugann réimse foirme ar ais.

\n

Is foclóir d'ainmneacha réimse samhail atá mapáilte chuig giuirléid é giuirléidí.

\n

Is liosta d'ainmneacha réimsí ba chóir a bheith logánach é localized_fields.

\n

Is foclóir d'ainmneacha réimse samhail atá mapáilte le lipéad é lipéad.

\n

Is foclóir d'ainmneacha réimse samhail atá mapáilte le téacs cabhrach é help_texts.

\n

Is foclóir d'ainmneacha réimse samhail é error_messages a mappáiltear le foclóir teachtaireachtaí earráide.

\n

Is foclóir é field_classes` d'ainmneacha réimse samhail a mappáiltear chuig rang réimse foirme.

\n

Féach: ref: modelforms-factory mar shampla úsáid.

\n

Ní mór duit liosta na réimsí a sholáthar go sainráite, trí argóintí eochairfhocal réimsí `réimsí ``nó ``eisiam, nó na tréithe comhfhreagracha ar aicme Meta istigh na foirme. Féach:ref: modelforms-selecting-fields le haghaidh tuilleadh faisnéise. Aon sainmhíniú ar na réimsí atá le húsáid a fhágáil, beidh eisceacht: exc: ~Django.Core.Exceptions.ImProperlyConfigured mar thoradh air.

\n
\n\n
\n
\n

modelformset_factoryLink to this heading#

\n
\n
\nmodelformset_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, absolute_max=None, can_delete_extra=True, renderer=None, edit_only=False)Link to this definition#
\n

Tugann sé rang FormSet ar ais don rang model `` `` `` ``.

\n

Argóintí samhail ``, `foirme, réimsí`, eisiam, formfield_callback`, giuirléidí `, réimsí logánaithe`, labels`, cabhrach_téacs`, earráid_teachtaireachtaí`, agus ``réimsí ``cuirtear go léir trí:func: ~django.forms.models.modelform_factory.

\n

Argóintí formset, extra`, can_delete`, can_ord`, max_num, bailate_max`, min_num`, bailate_min`, bailate_min`, absolute_max`, can_delete_extra`, agus renderer cuirtear trí:func: ~django.forms.formsets.formsets.formset_factory. Féach: doc: formsets le haghaidh sonraí </topics/forms/formsets>.

\n

<model-formsets-edit-only>Ceadaíonn an argóint edit_only`: ref: `chruthú rudaí nua a chosc `.

\n

Féach: ref: model-formsets mar shampla úsáid.

\n
\n\n
\n
\n

inlineformset_factoryLink to this heading#

\n
\n
\ninlineformset_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, absolute_max=None, can_delete_extra=True, renderer=None, edit_only=False)Link to this definition#
\n

Tugann inlineFormSet ar ais ag baint úsáid:func: modelformset_factory le réamhshocraithe formSet = ``:class: `~django.forms.models.baseineFormSet`, ``can_delete=True, agus extra=3.

\n

Má tá níos mó ná ceann amháin: class: ~django.db.models.foreignKey ag do mhúnla go dtí an parent_model, ní mór duit fk_name a shonrú.

\n

Féach: ref: inline-formsets mar shampla úsáid.

\n
\n\n
\n
","rootId":"module-django.forms.models","toc":[{"title":"Model form Meta API","anchor":"model-form-meta-api","children":[{"title":"teachtaireachtaí earráid","anchor":"error-messages","children":[]},{"title":"exclude","anchor":"exclude","children":[]},{"title":"field_classes","anchor":"field-classes","children":[]},{"title":"``réimsí ``","anchor":"fields","children":[]},{"title":"formfield_callback","anchor":"formfield-callback","children":[]},{"title":"help_texts","anchor":"help-texts","children":[]},{"title":"labels","anchor":"labels","children":[]},{"title":"localized_fields","anchor":"localized-fields","children":[]},{"title":"``Samhail ``","anchor":"model","children":[]},{"title":"widgets","anchor":"widgets","children":[]}]},{"title":"Model form factory functions","anchor":"model-form-factory-functions","children":[{"title":"modelform_factory","anchor":"modelform-factory","children":[]},{"title":"modelformset_factory","anchor":"modelformset-factory","children":[]},{"title":"inlineformset_factory","anchor":"inlineformset-factory","children":[]}]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/5.2/ref/"},{"docname":"ref/forms/index","title":"Foirmeacha","url":"/ga/5.2/ref/forms/"}],"prev":{"docname":"ref/forms/fields","title":"Réimsí foirm","url":"/ga/5.2/ref/forms/fields/"},"next":{"docname":"ref/forms/formsets","title":"Feidhmeanna Formset","url":"/ga/5.2/ref/forms/formsets/"},"formats":{"html":"/ga/5.2/ref/forms/models/","markdown":"/ga/5.2/ref/forms/models.md","json":"/ga/5.2/ref/forms/models.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/ref/forms/models.txt","official":"https://docs.djangoproject.com/ga/5.2/ref/forms/models/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}