Widgets formulir Django dibangun menggunakan Django's template engines system.
\nPengolahan membangun formulir dapat disesuaikan pada beberapa tingkat:
\nWidget dapat menentukan nama-nama cetakan penyesuaian.
Formulir dan widget dapat menentukan kelas-kelas pembangun penyesuaian.
Sebuah cetakan widget dapat ditimpa oleh sebuah proyek. (Menggunakan kembali aplikasi tertentu jangan menimpa cetakan siap-pakai karena mereka mungkin bertentangan dengan cetakan-cetakan penyesuaian proyek.)
Pembangunan dari cetakan formulir dikendalikan oleh kelas pembangun penyesuaian. Sebuah pembangun penyesuaian dapat ditentukan dengan memperbaharui pengaturan FORM_RENDERER. Awalan itu pada 'django.forms.renderers.DjangoTemplates'.
By specifying a custom form renderer and overriding\nform_template_name you can adjust the default form\nmarkup across your project from a single place.
You can also provide a custom renderer per-form or per-widget by setting the\nForm.default_renderer attribute or by using the renderer argument\nof Form.render(), or Widget.render().
Matching points apply to formset rendering. See Menggunakan sebuah formset dalam tampilan dan cetakan for\ndiscussion.
\nGunakan satu dari built-in template form renderers atau menerapkan anda sendiri. Pembangun penyesuaian harus menerapkan sebuah metode render(template_name, context, request=None). Itu harus mengembalikan sebuah cetakan terbangun (sebagai string) atau memunculkan TemplateDoesNotExist.
The base class for the built-in form renderers.
\nThe default name of the template to use to render a form.
\nDefaults to "django/forms/default.html", which is a proxy for\n"django/forms/table.html".
The "django/forms/default.html" template is deprecated and will be\nremoved in Django 5.0. The default will become\n"django/forms/div.html" at that time.
The default name of the template to use to render a formset.
\nDefaults to "django/forms/formsets/default.html", which is a proxy\nfor "django/forms/formsets/table.html".
The "django/forms/formset/default.html" template is deprecated and\nwill be removed in Django 5.0. The default will become\n"django/forms/formset/div.html" template.
Subclasses must implement this method with the appropriate template\nfinding logic.
\nRenders the given template, or raises\nTemplateDoesNotExist.
DjangoTemplatesLink to this heading#This renderer uses a standalone\nDjangoTemplates\nengine (unconnected to what you might have configured in the\nTEMPLATES setting). It loads templates first from the built-in form\ntemplates directory in django/forms/templates and then from the\ninstalled apps' templates directories using the app_directories loader.
Jika anda ingin membangun cetakan dengan penyesuaian dari pengaturan TEMPLATES anda, seperti pengeolah konteks sebagai contoh, gunakan pembangun TemplatesSetting.
Subclass of DjangoTemplates that specifies\nform_template_name and\nformset_template_name as "django/forms/div.html" and\n"django/forms/formset/div.html" respectively.
This is a transitional renderer for opt-in to the new <div> based\ntemplates, which are the default from Django 5.0.
Apply this via the FORM_RENDERER setting:
FORM_RENDERER = "django.forms.renderers.DjangoDivFormRenderer"\nOnce the <div> templates are the default, this transitional renderer will\nbe deprecated, for removal in Django 6.0. The FORM_RENDERER declaration can\nbe removed at that time.
Jinja2Link to this heading#This renderer is the same as the DjangoTemplates renderer except that\nit uses a Jinja2 backend. Templates\nfor the built-in widgets are located in django/forms/jinja2 and\ninstalled apps can provide templates in a jinja2 directory.
To use this backend, all the forms and widgets in your project and its\nthird-party apps must have Jinja2 templates. Unless you provide your own Jinja2\ntemplates for widgets that don't have any, you can't use this renderer. For\nexample, django.contrib.admin doesn't include Jinja2 templates for its\nwidgets due to their usage of Django template tags.
A transitional renderer as per DjangoDivFormRenderer above, but\nsubclassing Jinja2 for use with the Jinja2 backend.
Apply this via the FORM_RENDERER setting:
FORM_RENDERER = "django.forms.renderers.Jinja2DivFormRenderer"\nTemplatesSettingLink to this heading#This renderer gives you complete control of how form and widget templates are\nsourced. It uses get_template() to find templates\nbased on what's configured in the TEMPLATES setting.
Using this renderer along with the built-in templates requires either:
\n'django.forms' in INSTALLED_APPS dan setidaknya satu mesin dengan APP_DIRS=True.
Adding the built-in templates directory in DIRS\nof one of your template engines. To generate that path:
import django\n\ndjango.__path__[0] + "/forms/templates" # or '/forms/jinja2'\nMenggunakan pembangun ini membutuhkan anda untuk memastikan cetakan formulir proyek anda butuhkan dapat ditempatkan.
\nFormset templates receive a context from BaseFormSet.get_context(). By\ndefault, formsets receive a dictionary with the following values:
formset: The formset instance.
Form templates receive a context from Form.get_context(). By default,\nforms receive a dictionary with the following values:
form: The bound form.
fields: All bound fields, except the hidden fields.
hidden_fields: All hidden bound fields.
errors: All non field related or hidden field related form errors.
Cetakan widget menerima sebuah konteks dari Widget.get_context(). Secara awalan, widget menerima sebuah nilai tunggal dalam konteks, widget. Ini adalah sebuah dictionary yang mengandung nilai-nilai seperti:
name
value
attrs
is_hidden
template_name
Beberapa widget menambah informasi lebih lanjut pada konteks. Sebagai contoh, semua widget yang subkelas Input menentukan widget['type'] dan MultiWidget menentukan widget['subwidgets'] untuk tujuan perulangan.
To override formset templates, you must use the TemplatesSetting\nrenderer. Then overriding formset templates works the same as overriding any other template in your project.
To override form templates, you must use the TemplatesSetting\nrenderer. Then overriding form templates works the same as overriding any other template in your project.
Setiap widget mempunyai sebuah atribut template_name dengan sebuah nilai seperti input.html. Cetakan widget siap-pakai disimpan dalam jalur django/forms/widgets. Anda dapat menyediakan cetakan penyesuaian untuk input.html dengan menentukan django/forms/widgets/input.html, sebagai contoh. Lihat Widget pasang tetap untuk nama dari setiap cetakan widget.
Untuk menimpa cetakan widget, anda harus menggunakan pembangun TemplatesSetting. Kemudian menimpa cetakan widget bekerja the same as menimpa cetakan lain apapun dalam proyek anda.