Componente Django Form
El componente Django Form se utiliza para inicializar la página, generar etiquetas HTML y, además, puede validar los datos enviados por el usuario (mostrando mensajes de error).
Orden de visualización de los mensajes de error:
- Primero se muestran los mensajes de error de los atributos del campo y, luego, los mensajes de error de los ganchos locales.
- Si se muestran los mensajes de error de los atributos del campo, no se mostrarán los mensajes de error de los ganchos locales.
- Si hay ganchos globales, estos comienzan a validar solo después de que todos los datos hayan sido validados, y los mensajes de error de los ganchos globales se mostrarán siempre.
Para usar el componente Form, primero debe importar forms:
from django import forms

A continuación, creamos un My_forms.py en el directorio app01:
app01/My_forms.py
from django import forms
from django.core.exceptions import ValidationError
from app01 import models
class EmpForm(forms.Form):
name = forms.CharField(min_length=4, label="Nombre", error_messages={"min_length": "Tu nombre es demasiado corto", "required": "¡Este campo no puede estar vacío!"})
age = forms.IntegerField(label="Edad")
salary = forms.DecimalField(label="Salario")
from django.core.exceptions import ValidationError
from app01 import models
class EmpForm(forms.Form):
name = forms.CharField(min_length=4, label="Nombre", error_messages={"min_length": "Tu nombre es demasiado corto", "required": "¡Este campo no puede estar vacío!"})
age = forms.IntegerField(label="Edad")
salary = forms.DecimalField(label="Salario")
Atributos del campo:
- label: Información de texto que aparece delante del cuadro de entrada.
- error_message: Mensaje de error personalizado; el valor del atributo es un diccionario, donde `required` es la clave del mensaje de error que se muestra cuando el campo no puede estar vacío.
app01/views.py
from django.shortcuts import render, HttpResponse
from app01.My_Forms import EmpForm
from app01 import models
from django.core.exceptions import ValidationError
# Create your views here.
def add_emp(request):
if request.method == "GET":
form = EmpForm()
return render(request, "add_emp.html", {"form": form})
else:
form = EmpForm(request.POST)
if form.is_valid(): # Realizar la validación de datos
# Validación exitosa
data = form.cleaned_data # Los valores validados correctamente se colocarán en cleaned_data.
data.pop('r_salary')
print(data)
models.Emp.objects.create(**data)
return HttpResponse(
'ok'
)
# return render(request, "add_emp.html", {"form": form})
else:
print(form.errors) # Imprimir los mensajes de error
clean_errors = form.errors.get("__all__")
print(222, clean_errors)
return render(request, "add_emp.html", {"form": form, "clean_errors": clean_errors})
from app01.My_Forms import EmpForm
from app01 import models
from django.core.exceptions import ValidationError
# Create your views here.
def add_emp(request):
if request.method == "GET":
form = EmpForm()
return render(request, "add_emp.html", {"form": form})
else:
form = EmpForm(request.POST)
if form.is_valid(): # Realizar la validación de datos
# Validación exitosa
data = form.cleaned_data # Los valores validados correctamente se colocarán en cleaned_data.
data.pop('r_salary')
print(data)
models.Emp.objects.create(**data)
return HttpResponse(
'ok'
)
# return render(request, "add_emp.html", {"form": form})
else:
print(form.errors) # Imprimir los mensajes de error
clean_errors = form.errors.get("__all__")
print(222, clean_errors)
return render(request, "add_emp.html", {"form": form, "clean_errors": clean_errors})
Agregue las siguientes reglas al archivo app01/urls.py:
path('add_emp/', views.add_emp)
Plantilla HTML:
app01/add_emp.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title></title>
</head>
<body>
<h3>Agregar empleado</h3>{#1. Escribir la página HTML manualmente#}<form action="" method="post">
<p>Nombre:<input type="text" name="name"></p>
<p>Edad:<input type="text" name="age"></p>
<p>Salario:<input type="text" name="salary"></p>
<input type="submit">
</form>{#2. Implementado mediante el método as_p del objeto form#}
{#<form action="" method="post" novalidate>#}
{# {% csrf_token %}#}
{# {{ form.as_p }}#}
{# <input type="submit">#}
{#</form>#}
{#3. Obtener manualmente los campos del objeto form#}
{#<form action="" method="post" novalidate>#}
{# {% csrf_token %}#}
{# <div>#}
{# <label for="id_{{ form.name.name }}">Nombre</label>#}
{# {{ form.name }} <span>{{ form.name.errors.0 }}</span>#}
{# </div>#}
{# <div>#}
{# <label for="id_{{ form.age.name }}">Edad</label>#}
{# {{ form.age }} <span>{{ form.age.errors.0 }}</span>#}
{# </div>#}
{# <div>#}
{# <label for="id_salary">Salario</label>#}
{# {{ form.salary }} <span>{{ form.salary.errors.0 }}</span>#}
{# </div>#}
{# <input type="submit">#}
{#</form>#}
{#4. Usar un bucle for para mostrar todos los campos#}
{#<form action="" method="post" novalidate>#}
{# {% csrf_token %}#}
{# {% for field in form %}#}
{# <div>#}
{# <label for="id_{{ field.name }}">{{ field.label }}</label>#}
{# {{ field }} <span>{{ field.errors.0 }}</span>#}
{# </div>#}
{# {% endfor %}#}
{# <input type="submit">#}
{#</form>#}
</body>
</html>
El resultado de la ejecución se muestra en la siguiente figura:

Ganchos locales y ganchos globales
Definir la clase Form:
app01/My_forms.py
from django import forms
from django.core.exceptions import ValidationError
from app01 import models
class EmpForm(forms.Form):
name = forms.CharField(min_length=5, label="Nombre", error_messages={"required": "¡Este campo no puede estar vacío!",
"min_length": "El nombre de usuario es demasiado corto."})
age = forms.IntegerField(label="Edad")
salary = forms.DecimalField(max_digits=5, decimal_places=2, label="Salario")
r_salary = forms.DecimalField(max_digits=5, decimal_places=2, label="Por favor, vuelva a ingresar el salario")
def clean_name(self): # Gancho local
val = self.cleaned_data.get("name")
if val.isdigit():
raise ValidationError("El nombre de usuario no puede ser solo números")
elif models.Emp.objects.filter(name=val):
raise ValidationError("¡El nombre de usuario ya existe!")
else:
return val
def clean(self): # Gancho global: confirma si los dos salarios ingresados son iguales.
val = self.cleaned_data.get("salary")
r_val = self.cleaned_data.get("r_salary")
if val == r_val:
return self.cleaned_data
else:
raise ValidationError("Por favor, confirme que los salarios coincidan.")
from django.core.exceptions import ValidationError
from app01 import models
class EmpForm(forms.Form):
name = forms.CharField(min_length=5, label="Nombre", error_messages={"required": "¡Este campo no puede estar vacío!",
"min_length": "El nombre de usuario es demasiado corto."})
age = forms.IntegerField(label="Edad")
salary = forms.DecimalField(max_digits=5, decimal_places=2, label="Salario")
r_salary = forms.DecimalField(max_digits=5, decimal_places=2, label="Por favor, vuelva a ingresar el salario")
def clean_name(self): # Gancho local
val = self.cleaned_data.get("name")
if val.isdigit():
raise ValidationError("El nombre de usuario no puede ser solo números")
elif models.Emp.objects.filter(name=val):
raise ValidationError("¡El nombre de usuario ya existe!")
else:
return val
def clean(self): # Gancho global: confirma si los dos salarios ingresados son iguales.
val = self.cleaned_data.get("salary")
r_val = self.cleaned_data.get("r_salary")
if val == r_val:
return self.cleaned_data
else:
raise ValidationError("Por favor, confirme que los salarios coincidan.")
Código del archivo views.py:
app01/views.py
def add_emp(request):
if request.method == "GET":
form = EmpForm() # Inicializar el objeto form
return render(request, "add_emp.html", {"form":form})
else:
form = EmpForm(request.POST) # Pasar los datos al objeto form
if form.is_valid(): # Realizar la validación
data = form.cleaned_data
data.pop("r_salary")
models.Emp.objects.create(**data)
return redirect("/index/")
else: # Validación fallida
clear_errors = form.errors.get("__all__") # Obtener los mensajes de error del gancho global
return render(request, "add_emp.html", {"form": form, "clear_errors": clear_errors})
if request.method == "GET":
form = EmpForm() # Inicializar el objeto form
return render(request, "add_emp.html", {"form":form})
else:
form = EmpForm(request.POST) # Pasar los datos al objeto form
if form.is_valid(): # Realizar la validación
data = form.cleaned_data
data.pop("r_salary")
models.Emp.objects.create(**data)
return redirect("/index/")
else: # Validación fallida
clear_errors = form.errors.get("__all__") # Obtener los mensajes de error del gancho global
return render(request, "add_emp.html", {"form": form, "clear_errors": clear_errors})
El código del archivo de plantilla es el siguiente:
app01/add_emp.html
<form action="" method="post" novalidate>
{% csrf_token %}
<div>
<label for="id_{{ form.name.name }}">Nombre</label>
{{ form.name }} <span>{{ form.name.errors.0 }}</span>
</div>
<div>
<label for="id_{{ form.age.name }}">Edad</label>
{{ form.age }} <span>{{ form.age.errors.0 }}</span>
</div>
<div>
<label for="id_salary">Salario</label>
{{ form.salary }} <span>{{ form.salary.errors.0 }}{{ clear_errors.0 }}</span>
</div>
<div>
<label for="id_r_salary">Por favor, vuelva a ingresar el salario</label>
{{ form.r_salary }} <span>{{ form.r_salary.errors.0 }}{{ clear_errors.0 }}</span>
</div>
<input type="submit">
</form>
El resultado de la ejecución se muestra en la siguiente figura:

