Общие представления редактирования¶
T
- T
django.views.generic.edit.CreateView
django.views.generic.edit.UpdateView
django.views.generic.edit.DeleteView
См.также
T
Примечание
T
from django.db import models
from django.urls import reverse
class Author(models.Model):
name = models.CharField(max_length=200)
def get_absolute_url(self):
return reverse('author-detail', kwargs={'pk': self.pk})
FormView
¶
-
class
django.views.generic.edit.
FormView
¶ Представление, отображающее форму. При ошибке происходит повторное отображение формы с ошибками валидации; при успехе происходит перенаправление на новый URL.
Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
django.views.generic.base.TemplateResponseMixin
django.views.generic.edit.BaseFormView
django.views.generic.edit.FormMixin
django.views.generic.edit.ProcessFormView
django.views.generic.base.View
Пример myapp/forms.py:
from django import forms class ContactForm(forms.Form): name = forms.CharField() message = forms.CharField(widget=forms.Textarea) def send_email(self): # send email using the self.cleaned_data dictionary pass
Пример myapp/views.py:
from myapp.forms import ContactForm from django.views.generic.edit import FormView class ContactFormView(FormView): template_name = 'contact.html' form_class = ContactForm success_url = '/thanks/' def form_valid(self, form): # This method is called when valid form data has been POSTed. # It should return an HttpResponse. form.send_email() return super().form_valid(form)
Пример myapp/contact.html:
<form method="post">{% csrf_token %} {{ form.as_p }} <input type="submit" value="Send message"> </form>
-
class
django.views.generic.edit.
BaseFormView
¶ Базовое представление для отображения формы. Оно не предназначено для непосредственного использования, а скорее как родительский класс
django.views.generic.edit.FormView
или других представлений, отображающих форму.Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
CreateView
¶
-
class
django.views.generic.edit.
CreateView
¶ Представление, которое отображает форму для создания объекта, повторного отображения формы с ошибками валидации (если таковые имеются) и сохранения объекта.
Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
django.views.generic.detail.SingleObjectTemplateResponseMixin
django.views.generic.base.TemplateResponseMixin
django.views.generic.edit.BaseCreateView
django.views.generic.edit.ModelFormMixin
django.views.generic.edit.FormMixin
django.views.generic.detail.SingleObjectMixin
django.views.generic.edit.ProcessFormView
django.views.generic.base.View
Атрибуты
-
template_name_suffix
¶ Страница
CreateView
, отображаемая на запросGET
, используетtemplate_name_suffix
из'_form'
. Например, изменение этого атрибута на'_create_form'
для представления, создающего объекты для примераAuthor
модели, приведет к тому, что по умолчаниюtemplate_name
будет'myapp/author_create_form.html'
.
-
object
¶ При использовании
CreateView
вы имеете доступ кself.object
, который является создаваемым объектом. Если объект еще не создан, то значение будетNone
.
Пример myapp/views.py:
from django.views.generic.edit import CreateView from myapp.models import Author class AuthorCreateView(CreateView): model = Author fields = ['name']
Пример myapp/author_form.html:
<form method="post">{% csrf_token %} {{ form.as_p }} <input type="submit" value="Save"> </form>
-
class
django.views.generic.edit.
BaseCreateView
¶ Базовое представление для создания нового экземпляра объекта. Оно не предназначено для непосредственного использования, а скорее как родительский класс
django.views.generic.edit.CreateView
.Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
Методы
-
get
(request, *args, **kwargs)¶ Устанавливает текущий экземпляр объекта (
self.object
) вNone
.
-
post
(request, *args, **kwargs)¶ Устанавливает текущий экземпляр объекта (
self.object
) вNone
.
-
UpdateView
¶
-
class
django.views.generic.edit.
UpdateView
¶ Представление, которое отображает форму для редактирования существующего объекта, повторного отображения формы с ошибками валидации (если они есть) и сохранения изменений в объекте. При этом используется форма, автоматически сгенерированная из класса модели объекта (если класс формы не указан вручную).
Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
django.views.generic.detail.SingleObjectTemplateResponseMixin
django.views.generic.base.TemplateResponseMixin
django.views.generic.edit.BaseUpdateView
django.views.generic.edit.ModelFormMixin
django.views.generic.edit.FormMixin
django.views.generic.detail.SingleObjectMixin
django.views.generic.edit.ProcessFormView
django.views.generic.base.View
Атрибуты
-
template_name_suffix
¶ Страница
UpdateView
, отображаемая наGET
запрос, используетtemplate_name_suffix
атрибут'_form'
. Например, изменение этого атрибута на'_update_form'
для представления, обновляющего объекты для примераAuthor
модели, приведет к тому, что по умолчаниюtemplate_name
будет'myapp/author_update_form.html'
.
-
object
¶ При использовании
UpdateView
вы имеете доступ кself.object
, который является обновляемым объектом.
Пример myapp/views.py:
from django.views.generic.edit import UpdateView from myapp.models import Author class AuthorUpdateView(UpdateView): model = Author fields = ['name'] template_name_suffix = '_update_form'
Пример myapp/author_update_form.html:
<form method="post">{% csrf_token %} {{ form.as_p }} <input type="submit" value="Update"> </form>
-
class
django.views.generic.edit.
BaseUpdateView
¶ Базовое представление для обновления существующего экземпляра объекта. Оно не предназначено для непосредственного использования, а скорее как родительский класс
django.views.generic.edit.UpdateView
.Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
Методы
-
get
(request, *args, **kwargs)¶ Устанавливает текущий экземпляр объекта (
self.object
).
-
post
(request, *args, **kwargs)¶ Устанавливает текущий экземпляр объекта (
self.object
).
-
DeleteView
¶
-
class
django.views.generic.edit.
DeleteView
¶ Представление, которое отображает страницу подтверждения и удаляет существующий объект. Данный объект будет удален, только если метод запроса
POST
. Если это представление получено черезGET
, оно отобразит страницу подтверждения, которая должна содержать форму POST на тот же URL.Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений:
django.views.generic.detail.SingleObjectTemplateResponseMixin
django.views.generic.base.TemplateResponseMixin
django.views.generic.edit.BaseDeleteView
django.views.generic.edit.DeletionMixin
django.views.generic.edit.FormMixin
django.views.generic.base.ContextMixin
django.views.generic.detail.BaseDetailView
django.views.generic.detail.SingleObjectMixin
django.views.generic.base.View
Атрибуты
-
form_class
¶ Наследуется от
BaseDeleteView
. Класс формы, которая будет использоваться для подтверждения запроса. По умолчаниюdjango.forms.Form
, что приводит к пустой форме, которая всегда действительна.Предоставив свой собственный подкласс
Form
, вы можете добавить дополнительные требования, такие как, например, флажок подтверждения.
-
template_name_suffix
¶ Страница
DeleteView
, отображаемая наGET
запрос, используетtemplate_name_suffix
атрибут'_confirm_delete'
. Например, изменение этого атрибута на'_check_delete'
для представления, удаляющего объекты для примераAuthor
модели, приведет к тому, что по умолчаниюtemplate_name
будет'myapp/author_check_delete.html'
.
Пример myapp/views.py:
from django.urls import reverse_lazy from django.views.generic.edit import DeleteView from myapp.models import Author class AuthorDeleteView(DeleteView): model = Author success_url = reverse_lazy('author-list')
Пример myapp/author_confirm_delete.html:
<form method="post">{% csrf_token %} <p>Are you sure you want to delete "{{ object }}"?</p> {{ form }} <input type="submit" value="Confirm"> </form>
-
class
django.views.generic.edit.
BaseDeleteView
¶ A
Предки (MRO).
Это представление наследует методы и атрибуты от следующих представлений: