Валидация форм

• Разработчик создал модель, на её основе создал форму, эту форму вывел в шаблон. Можно создать форму и без модели, если хранить полученные данные не нужно.
• Пользователь заходит на страницу с формой, заполняет её и нажимает «Отправить», браузер пользователя отправляет POST-запрос с данными на URL, указанный в параметре action формы.
• На сервере данные из формы проверяются и обрабатываются во view-функции.
• Если данные успешно прошли проверку — они передаются для дальнейшей обработки и сохранения в базе, а пользователь перенаправляется на страницу с информацией об успешной отправке формы.
• Если отправленные данные не прошли проверку, пользователю отправляется уведомление об ошибке.

• Формы Django можно связывать с объектами модели.
• На основе моделей можно быстро, буквально несколькими строками кода, создавать новые формы.
• Данные, полученные от пользователя, автоматически разбираются обработчиком запроса.
• Django умеет передавать данные, полученные от пользователя, в объект формы.
• У форм есть система валидации — проверки качества переданных данных. Пользователь может ошибиться или раньше времени нажать кнопку «Отправить» — в этих случаях данные не пройдут проверку и пользователь получит сообщение об этом.
• Во все формы Django по умолчанию встроена защита от злонамеренной отправки данных из другого источника, Cross Site Request Forgery (CSRF).
• В Django предусмотрен набор встроенных виджетов — шаблонов, формирующих HTML-код формы: поля для ввода текста (HTML-тег <input type="text">), поля многострочного ввода<textarea>, чекбоксы <input type="checkbox">, выпадающие списки <select> и множество других, стандартных и нестандартных, элементов.

Скопировать кодPYTHON
from django.forms import ModelForm
from post.models import Post

# cоздание класса формы
class PostForm(ModelForm):
    class Meta:
        model = Post
        fields = ['pub_date', 'text']

# создание формы для отправки постов
form = PostForm()

# создание формы для редактирования конкретного объекта модели Post
# запрашиваем объект
post = Post.objects.get(pk=3)
# передаём запрошенный объект в форму
form = PostForm(instance=post)

• если в модели есть поле типа ForeignKey, то в форме будет отрисовано поле выбора ModelChoiceField, <select> для выбора объекта связанной модели;
• для поля модели ManyToManyField в форме будет применён виджет ModelMultipleChoiceField, поле для множественного выбора из списка;
• для поля модели SlugField в форме отобразится поле SlugField. Это специальное текстовое поле <input type="text"> умеет создавать красивые URL для объектов и проверять, что строка состоит только из разрешённых для URL символов. Например, для этого урока SlugField предложил бы URL /validatsiya-form

Валидация форм

Скопировать кодPYTHON
from django import forms

class ContactForm(forms.Form):
    subject = forms.CharField(max_length=100)
    message = forms.CharField(widget=forms.Textarea)
    sender = forms.EmailField()
    cc_myself = forms.BooleanField(required=False)

• Для любого поля модели или формы можно указать аргумент validators и в нём перечислить функции-валидаторы для этого поля. При получении данных валидаторы вызываются автоматически, им передаётся значение поля, и в случае ошибки валидации вызывается исключение ValidationError

Скопировать кодPYTHON
# функция-валидатор:
def validate_positive(value):
    if value <= 0:
        raise forms.ValidationError(
                'Значение меньше нуля',
                params={'value': value},
        ) 

# можно указать валидатор для свойства (поля) модели
class MyModel(models.Model):
    number_field = models.IntegerField(validators=[validate_positive])

# ...а можно указать валидатор для свойства (поля) формы
class MyForm(forms.Form):
    number_field = forms.IntegerField(validators=[validate_positive])

• В классе формы для каждого отдельного поля можно создать метод clean_<имя поля>, он вызовется автоматически во время валидации данных. Этот метод не получает никаких дополнительных параметров: он должен самостоятельно запросить значение из словаря cleaned_data. Такой протокол создан для того, чтобы можно было совместить работу всех валидаторов. Значение, которое вернёт этот метод, обновит значение соответствующего элемента словаря cleaned_data.

Скопировать кодPYTHON
class ContactForm(forms.Form):
    # форма обратной связи
    ...
    # метод-валидатор для поля subject
    def clean_subject(self):
        data = self.cleaned_data['subject']
        # если пользователь не поблагодарил администратора - считаем это ошибкой
        if "спасибо" not in data.lower():
                raise forms.ValidationError("Вы обязательно должны нас поблагодарить!")

        # метод-валидатор обязательно должен вернуть очищенные данные, даже если не изменил их
        return data

Скопировать кодPYTHON
if form.is_valid():
    subject = form.cleaned_data['subject']
    message = form.cleaned_data['message']
    sender = form.cleaned_data['sender']
    cc_myself = form.cleaned_data['cc_myself']

Работа с пользовательскими данными

Скопировать кодPYTHON
from django import forms


# создаём форму
class ContactForm(forms.Form):
    subject = forms.CharField(max_length=100)
    message = forms.CharField(widget=forms.Textarea)
    sender = forms.EmailField()
    cc_myself = forms.BooleanField(required=False)

Скопировать кодPYTHON
from django.shortcuts import redirect

def user_contact(request):
    # проверим, пришёл ли к нам POST-запрос или какой-то другой:
    if request.method == 'POST':
        # создаём объект формы класса ContactForm и передаём в него полученные данные
        form = ContactForm(request.POST)
        # проверяем данные на валидность:
        # ... здесь код валидации ...

        if form.is_valid():
            # обрабатываем данные формы, используя значения словаря form.cleaned_data
            # возвращаем результат
            # Функция redirect перенаправляет пользователя 
            # на другую страницу сайта, чтобы защититься 
            # от повторного заполнения формы, если посетитель
            # сайта случайно перезагрузит страницу
            return redirect('/thank-you/')

        # если не сработало условие if form.is_valid() и данные не прошли валидацию
        # сработает следующий блок кода,
        # иначе команда return прервала бы дальнейшее исполнение функции

        # вернём пользователю страницу с HTML-формой и передадим полученный объект формы на страницу, 
        # чтобы вернуть информацию об ошибке

        # заодно автоматически заполним прошедшими валидацию данными все поля, 
        # чтобы не заставлять пользователя второй раз заполнять их
        return render(request, 'contact.html', {'form': form})

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