As seguintes views são descritas nesta pagina e fornece uma base para edição de conteúdo:
django.views.generic.edit.FormView
django.views.generic.edit.CreateView
django.views.generic.edit.UpdateView
django.views.generic.edit.DeleteView
Ver também
The messages framework contains
SuccessMessageMixin
, which
facilitates presenting messages about successful form submissions.
Nota
Alguns dos exemplos nesta página assumem que um model “Author” foi defenido como se segue em 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
¶django.views.generic.edit.
FormView
¶É uma view que mostra um formulario. Caso tenha um erro da validação é exibido o formulario com os erros para se corrido. Caso o formulario passe pela validação é direcionado para uma nova URL.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
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
Exemplo 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
Exemplo 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)
Examplo myapp/contact.html:
<form method="post">{% csrf_token %}
{{ form.as_p }}
<input type="submit" value="Send message">
</form>
django.views.generic.edit.
BaseFormView
¶A base view for displaying a form. It is not intended to be used directly,
but rather as a parent class of the
django.views.generic.edit.FormView
or other views displaying a
form.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
CreateView
¶django.views.generic.edit.
CreateView
¶Uma view que exibi um formulário para a criação de um objeto, reexibindo o formulário com errors de validações(se houver algum), e salvando o objeto.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
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
Atributos
template_name_suffix
¶A página “CreateView” apresentada após uma requisição do tipo “GET”, utiliza um “template_name_suffix” de “_form”. Ao alterar este atributo para '_create_form'
, por exemplo, para uma view que esteja criando objetos para o exemplo “Author” model, faria com que o template_name
padrão fosse 'myapp/author_create_form.html'
.
object
¶Ao utilizar “CreateView”, você tem acesso ao “self.object”, que é o objeto que está sendo criado. Caso o objeto não tenha sido criado ainda, o valor será “None”.
Exemplo myapp/views.py:
from django.views.generic.edit import CreateView
from myapp.models import Author
class AuthorCreateView(CreateView):
model = Author
fields = ['name']
Exemplo myapp/author_form.html:
<form method="post">{% csrf_token %}
{{ form.as_p }}
<input type="submit" value="Save">
</form>
django.views.generic.edit.
BaseCreateView
¶A base view for creating a new object instance. It is not intended to be
used directly, but rather as a parent class of the
django.views.generic.edit.CreateView
.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
Métodos
get
(request, *args, **kwargs)¶Sets the current object instance (self.object
) to None
.
post
(request, *args, **kwargs)¶Sets the current object instance (self.object
) to None
.
UpdateView
¶django.views.generic.edit.
UpdateView
¶Uma view que apresenta um form para editar um objeto existente, reapresentando este form com erros de validação (caso exista algum) e salvando as alterações no objeto. Aqui será utilizado um form que foi gerado automaticamente à partir da classe definida no “model” (à menos que seja manualmente especificada uma class que esteja definida em form).
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
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
Atributos
template_name_suffix
¶A página “UpdateView” que é mostrada após uma requisição “GET”, utiliza um “emplate_name_suffix” de '_form'
. Caso este atributo fosse alterado para '_update_form'
, para uma view que esteja atualizando objetos de um model “Author”, por exemplo, faria com que o template_name
fosse 'myapp/author_update_form.html'
.
object
¶Ao utilizar “UpdateView”, você tem acesso ao “self.object”, que é o objeto que está sendo atualizado.
Exemplo 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'
Exemplo myapp/author_update_form.html:
<form method="post">{% csrf_token %}
{{ form.as_p }}
<input type="submit" value="Update">
</form>
django.views.generic.edit.
BaseUpdateView
¶A base view for updating an existing object instance. It is not intended to
be used directly, but rather as a parent class of the
django.views.generic.edit.UpdateView
.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
Métodos
get
(request, *args, **kwargs)¶Sets the current object instance (self.object
).
post
(request, *args, **kwargs)¶Sets the current object instance (self.object
).
DeleteView
¶django.views.generic.edit.
DeleteView
¶Uma view que apresenta uma página de confirmação e deleta um objeto existente. O dado objeto, será somente deletado se o tipo de request for “POST”. Caso esta mesma view receba um request do tipo “GET”, será apresentada uma página de confirmação que deverá conter um form que será retornada para a mesma URL.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
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
Atributos
form_class
¶Inherited from BaseDeleteView
. The
form class that will be used to confirm the request. By default
django.forms.Form
, resulting in an empty form that is always
valid.
By providing your own Form
subclass, you can add additional
requirements, such as a confirmation checkbox, for example.
template_name_suffix
¶The DeleteView
page displayed to a GET
request uses a
template_name_suffix
of '_confirm_delete'
. For
example, changing this attribute to '_check_delete'
for a view
deleting objects for the example Author
model would cause the
default template_name
to be 'myapp/author_check_delete.html'
.
Exemplo 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')
Exemplo 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>
django.views.generic.edit.
BaseDeleteView
¶A base view for deleting an object instance. It is not intended to be used
directly, but rather as a parent class of the
django.views.generic.edit.DeleteView
.
Ancestrais (MRO)
Essa “view” herda métodos e atributos das seguintes “views”:
django.views.generic.edit.DeletionMixin
django.views.generic.edit.FormMixin
django.views.generic.detail.BaseDetailView
In older versions, BaseDeleteView
does not inherit from
FormMixin
.
mar. 08, 2023