¿Cómo creo formularios personalizados y los conecto a una vista?

1. Introducción a los Formularios en Django

Los formularios en Django permiten a los usuarios enviar datos a una aplicación, como información de contacto, comentarios o cualquier otra entrada. Crear formularios personalizados facilita la captura de datos específicos y su validación.

2. Creación de un Formulario en Django

Para crear un formulario personalizado en Django, sigue estos pasos:

Paso 1: Definir el Formulario en un Archivo llamado forms.py

En la aplicación de tu proyecto, crea un archivo llamado forms.py si no existe ya. Luego define una clase de formulario usando forms.Form o forms.ModelForm si el formulario está basado en un modelo.

        
from django import forms

class ContactoForm(forms.Form):
    nombre = forms.CharField(label='Nombre', max_length=100)
    correo = forms.EmailField(label='Correo Electrónico')
    mensaje = forms.CharField(label='Mensaje', widget=forms.Textarea)

Explicación:

nombre: Campo de texto que acepta hasta 100 caracteres.
correo: Campo de correo electrónico que valida automáticamente si es un email válido.
mensaje: Campo de texto largo con el widget Textarea para una caja de texto más grande.

3. Conectar el Formulario a una Vista

Para procesar los datos del formulario, necesitas conectarlo a una vista. A continuación se muestra cómo hacerlo:

Paso 2: Crear la Vista en views.py

En el archivo views.py de tu aplicación, importa el formulario y define una vista para manejar el formulario.

        
from django.shortcuts import render
from .forms import ContactoForm

def contacto(request):
    if request.method == 'POST':
        form = ContactoForm(request.POST)
        if form.is_valid():
            nombre = form.cleaned_data['nombre']
            correo = form.cleaned_data['correo']
            mensaje = form.cleaned_data['mensaje']
            # Aquí puedes manejar los datos, como guardarlos o enviar un correo
            return render(request, 'contacto/gracias.html', {'nombre': nombre})
    else:
        form = ContactoForm()
    return render(request, 'contacto/contacto.html', {'form': form})

Explicación:

Se crea la vista contacto que maneja los datos POST del formulario.
Si el formulario es válido, los datos ingresados se almacenan en variables y se puede procesar la información.
Si el formulario no ha sido enviado (GET), se crea una instancia vacía del formulario.
Finalmente, la vista renderiza una plantilla HTML y pasa el formulario a la plantilla.

4. Crear una Plantilla para el Formulario

La plantilla renderiza el formulario en el navegador. Crea un archivo HTML en tu carpeta de plantillas, como contacto/contacto.html:

        
<!DOCTYPE html>
<html lang="es">
<head>
    <meta charset="UTF-8">
    <title>Formulario de Contacto</title>
</head>
<body>
    <h1>Formulario de Contacto</h1>
    <form method="post">
        {% csrf_token %}
        {{ form.as_p }}
        <button type="submit">Enviar</button>
    </form>
</body>
</html>

Explicación:

{% csrf_token %}: Proporciona un token para protegerse contra ataques CSRF (Cross-Site Request Forgery).
{{ form.as_p }}: Muestra cada campo del formulario dentro de etiquetas <p>.
El botón "Enviar" permite enviar los datos del formulario al servidor.

5. Conclusión

Al definir un formulario en forms.py, conectarlo con una vista en views.py y renderizarlo en una plantilla, puedes crear formularios personalizados en Django que permiten la captura y el manejo de datos de manera estructurada y segura.

Buscar este blog

Vía Electrónica