Общие представления для редактирования

На этой странице описаны следующие представления, которые обеспечивают основу для редактирования контента:

django.views.generic.edit.FormView
django.views.generic.edit.CreateView
django.views.generic.edit.UpdateView
django.views.generic.edit.DeleteView

См. также

Фреймворк сообщений содержит SuccessMessageMixin, который помогает отображать сообщения об успешной отправке формы.

Примечание

Некоторые примеры на этой странице предполагают, что модель Author определена следующим образом в myapp/models.py:

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)

Это представление наследует методы и атрибуты от следующих представлений:

Пример 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)

Это представление наследует методы и атрибуты от следующих представлений:

Атрибуты

template_name_suffix: Страница, отображаемая для запроса типа GET, использует суффикс '_form'. Например, изменение этого атрибута на '_create_form' для представления, создающего объекты для модели Author, приведет к тому, что значение по умолчанию будет '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)

Это представление наследует методы и атрибуты от следующих представлений:

Атрибуты

template_name_suffix: Страница, отображаемая для запроса типа GET, использует суффикс '_form'. Например, изменение этого атрибута на '_update_form' для представления, обновляющего объекты для модели Author, приведет к тому, что значение по умолчанию будет '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)

Этот вид наследует методы и атрибуты от следующих видов:

Атрибуты

form_class

Унаследован от BaseDeleteView. Класс формы, который будет использоваться для подтверждения запроса. По умолчанию django.forms.Form, что приводит к пустой форме, которая всегда валидна.

Предоставив свой собственный Form подкласс, вы можете добавить дополнительные требования, такие как флажок подтверждения, например.

template_name_suffix: Страница, отображаемая в ответе на запрос DeleteView, использует шаблон 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

Базовый вид для удаления экземпляра объекта. Он не предназначен для непосредственного использования, а скорее как родительский класс для django.views.generic.edit.DeleteView.

Предки (MRO)

Этот вид наследует методы и атрибуты от следующих видов:

© Django Software Foundation and individual contributors
Licensed under the BSD License.
https://docs.djangoproject.com/en/5.1/ref/class-based-views/generic-editing/