Что такое ModelForm в Django?

В Django ModelForm — это специальный класс формы, который автоматически генерирует поля формы на основе полей указанной модели. Он значительно упрощает создание форм для взаимодействия с моделями базы данных, включая валидацию данных и их сохранение.

Почему используется ModelForm?

• Сокращение boilerplate-кода: Автоматически создает поля формы, виджеты и метки на основе модели.
• Встроенная валидация: Предоставляет автоматическую валидацию данных, соответствующую ограничениям модели (например, max_length, unique, choices).
• Упрощенное сохранение: Позволяет легко сохранять данные формы в базу данных, создавая или обновляя экземпляры модели.

Основные преимущества:

• Автоматическое создание полей формы из модели.
• Встроенная валидация данных, соответствующая модели.
• Упрощенное сохранение данных в БД с помощью метода save().
• Поддержка кастомизации полей, виджетов и валидаторов.

Пример создания ModelForm:

Предположим, у нас есть модель Article:

# models.py
from django.db import models

class Article(models.Model):
    title = models.CharField(max_length=200)
    content = models.TextField()
    published = models.BooleanField(default=False)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.title

Создание ArticleForm:

# forms.py
from django import forms
from .models import Article

class ArticleForm(forms.ModelForm):
    class Meta:
        model = Article
        fields = ['title', 'content', 'published'] # Поля, которые будут включены в форму
        # exclude = ['created_at'] # Альтернатива: исключить поля
        widgets = {
            'title': forms.TextInput(attrs={'class': 'form-control'}),
            'content': forms.Textarea(attrs={'rows': 5, 'class': 'form-control'}),
        }

Пример использования ModelForm во вьюхе:

# views.py
from django.shortcuts import render, redirect, get_object_or_404
from .forms import ArticleForm
from .models import Article

def create_article(request):
    if request.method == 'POST':
        form = ArticleForm(request.POST) # Привязываем данные из POST-запроса
        if form.is_valid():
            form.save()  # Сохраняет новый объект Article в БД
            return redirect('article_list') # Перенаправляем на список статей
    else:
        form = ArticleForm() # Пустая форма для GET-запроса
    return render(request, 'articles/article_form.html', {'form': form})

def update_article(request, pk):
    article = get_object_or_404(Article, pk=pk)
    if request.method == 'POST':
        form = ArticleForm(request.POST, instance=article) # Обновляем существующий объект
        if form.is_valid():
            form.save() # Сохраняет изменения в существующем объекте Article
            return redirect('article_detail', pk=article.pk)
    else:
        form = ArticleForm(instance=article) # Заполняем форму данными существующего объекта
    return render(request, 'articles/article_form.html', {'form': form})

ModelForm является мощным инструментом для быстрой разработки веб-приложений в Django, значительно упрощая взаимодействие между пользовательским интерфейсом и базой данных.