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

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

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, использует 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)

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

Атрибуты

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

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

Атрибуты

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>
    <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/3.2/ref/class-based-views/generic-editing/