Освоєння форм Django для введення користувачами та перевірки

Форми Django є потужним інструментом для обробки даних, введених користувачем, і перевірки даних. Вони дозволяють створювати форми, які можуть збирати, обробляти та перевіряти дані безпечним і зручним способом. Ця стаття проведе вас через основи роботи з формами Django та як опанувати їх використання для ефективної обробки та перевірки введених даних користувачами.

Що таке Django Forms?

Форми Django — це класи Python, які обробляють дані форми. Їх можна використовувати для відтворення HTML-форм, обробки надісланих даних і перевірки введених даних. Форми в Django тісно інтегровані з моделями Django, що дозволяє легко перевіряти та зберігати дані в базі даних. Ви можете думати про форми Django як про спосіб автоматизації створення форм, перевірки даних і обробки помилок.

Створення простої форми Django

Почнемо зі створення простої форми для збору введених користувачем даних. Ми створимо форму для збору імені та адреси електронної пошти користувача.

from django import forms

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()

У наведеному вище коді ми створили форму під назвою ContactForm, яка містить два поля: ім’я та електронна пошта. CharField використовується для введення тексту, а EmailField гарантує, що введена адреса є дійсною електронною адресою.

Відтворення форм у шаблонах

Після того, як вашу форму визначено, її потрібно відобразити в шаблоні. Ви можете відобразити форму в Django за допомогою тегу шаблону {{ form }}, який автоматично створить HTML для кожного поля форми.

{% load static %}

<form method="POST" action="">
    {% csrf_token %}
    {{ form.as_p }}
    Submit</button>
</form>

У цьому коді шаблону ми використовуємо form.as_p для відтворення полів форми в тегах абзаців. {% csrf_token %} використовується для включення маркера CSRF з метою безпеки під час обробки надсилання форм.

Перевірка даних форми

Перевірка є важливою частиною будь-якої форми. Форми Django забезпечують автоматичну перевірку на основі типів полів, але ви також можете додати спеціальну логіку перевірки для забезпечення цілісності даних.

Вбудована перевірка полів

Поля Django мають вбудовану перевірку. Наприклад, EmailField автоматично перевірить, чи введена адреса є дійсною електронною адресою. Якщо введення недійсне, форма поверне повідомлення про помилку.

Спеціальні методи перевірки

Ви також можете створити власні методи перевірки, щоб застосувати складніші правила перевірки. Ось приклад, у якому ми підтверджуємо, що домен електронної пошти належить певній компанії.

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()

    def clean_email(self):
        email = self.cleaned_data['email']
        if '@company.com' not in email:
            raise forms.ValidationError("Email must be from company.com domain.")
        return email

У наведеному вище коді ми визначаємо метод clean_email, який перевіряє, чи електронний лист містить '@company.com'. Якщо цього не відбувається, виникає ValidationError, і форма відображатиме повідомлення про помилку.

Обробка подання форми

Після надсилання форми ви можете отримати доступ до даних форми у функції перегляду. Ось як ви можете обробити надсилання форми:

from django.shortcuts import render
from .forms import ContactForm

def contact_view(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)
        if form.is_valid():
            # Process the data, e.g., save to the database or send email
            name = form.cleaned_data['name']
            email = form.cleaned_data['email']
            # Handle the data as needed
            return render(request, 'success.html', {'name': name})
    else:
        form = ContactForm()

    return render(request, 'contact.html', {'form': form})

У цьому прикладі, коли форму надсилають, ми перевіряємо її дійсність за допомогою form.is_valid(). Якщо форма дійсна, ми отримуємо доступ до очищених даних і обробляємо їх. Якщо ні, Django автоматично покаже користувачеві відповідні повідомлення про помилки.

Відображення помилок форми

Django автоматично додає повідомлення про помилки до недійсних полів форми. Ви можете відобразити ці повідомлення про помилки у своєму шаблоні, щоб надати відгук користувачеві. Ось приклад:

{% if form.errors %}

{% for field in form %} {% for error in field.errors %}
• {{ error }}
{% endfor %} {% endfor %}

{% endif %}

У цьому коді ми перевіряємо, чи є у формі помилки, і переглядаємо кожне поле форми, щоб відобразити відповідні повідомлення про помилки.

Використання форм із моделями

Django також дозволяє легко прив’язувати форми до моделей за допомогою ModelForm. ModelForm автоматично створює поля форми на основі полів моделі, що спрощує процес створення форм для моделей баз даних.

Створення ModelForm

Ось приклад використання ModelForm для створення форми на основі моделі:

from django.db import models
from django import forms

class Contact(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()

class ContactForm(forms.ModelForm):
    class Meta:
        model = Contact
        fields = ['name', 'email']

У цьому коді ми маємо модель Contact з полями name і email. ContactForm — це ModelForm, яка автоматично генерує поля форми на основі моделі Contact.

Висновок

Оволодіння формами Django дозволяє ефективно та безпечно обробляти дані користувача. Використовуючи вбудовану перевірку, користувацькі методи перевірки та інтеграцію моделі, ви можете забезпечити безперебійну роботу користувача та зберегти цілісність даних у своїх програмах Django. Попрактикуйтесь у створенні та використанні форм, щоб стати більш досвідченими в обробці різних типів введення користувачами.