Jak fungují Django formuláře?

Question

Accepted Answer

Django **formuláře** spravují celý životní cyklus vstupu uživatele: vykreslování HTML polí formuláře, **validaci** odeslených dat a jejich převod na čisté hodnoty Pythonu. Abstrahují nudnou a chybě náchylnou práci ručního zpracování a validace vstupu — hlavní prvek produktivity a zabezpečení. ## Základní formulář ```python from django import forms class ContactForm(forms.Form): name = forms.CharField(max_length=100) email = forms.EmailField() # validates email format age = forms.IntegerField(min_value=0, required=False) message = forms.CharField(widget=forms.Textarea) ``` Každé pole formuláře deklaruje svůj typ a pravidla validace. Formulář se může sám vykreslit jako HTML a validovat vstup podle těchto pravidel. ## Zpracování formuláře v view (standardní vzor) ```python def contact(request): if request.method == "POST": form = ContactForm(request.POST) # bind submitted data if form.is_valid(): # run validation # cleaned_data = validated, type-converted Python values name = form.cleaned_data["name"] send_email(form.cleaned_data) return redirect("success") else: form = ContactForm() # empty form for GET return render(request, "contact.html", {"form": form}) ``` Klíčové metody: `is_valid()` spouští validaci, a po úspěchu `cleaned_data` vám dává bezpečné, validované, typem převedené hodnoty. Při selhání si formulář zachová vstup a shromáždí chybové zprávy. ## ModelForms — formuláře z modelů (DRY) ```python from django.forms import ModelForm class ArticleForm(ModelForm): class Meta: model = Article # build the form FROM a model fields = ["title", "body", "published"] # which fields to include # ModelForm can SAVE directly to the database def create(request): form = ArticleForm(request.POST) if form.is_valid(): form.save() # creates/updates the model instance! ``` **ModelForms** automaticky generují formulář z polí modelu a mohou ukládat přímo do databáze — ztělesnění principu DRY (model řídí formulář), eliminují boilerplate kód pro CRUD formuláře. ## Vlastní validace ```python class SignupForm(forms.Form): password = forms.CharField() confirm = forms.CharField() def clean_password(self): # field-level validation pw = self.cleaned_data["password"] if len(pw) < 8: raise forms.ValidationError("Too short") return pw def clean(self): # form-level (cross-field) validation data = super().clean() if data.get("password") != data.get("confirm"): raise forms.ValidationError("Passwords don't match") ``` ## Vykreslování a bezpečnost ```html ``` Formuláře se integrují s Django **CSRF ochranou** (`{% csrf_token %}`) a automaticky vykresluí pole s chybami validace. ## Proč na tom záleží Django formuláře jsou klíčová funkce pro bezpečné a produktivní zpracování vstupu uživatele — a správné zpracování vstupu je jak všudypřítomné (téměř každá aplikace má formuláře), tak kritické z hlediska bezpečnosti. Porozumění formulářům je nezbytné, protože abstrahují nudnou a chybě náchylnou práci zpracování vstupu: vykreslování HTML polí, **validaci** dat proti pravidlům, převod na čisté typované hodnoty Pythonu (`cleaned_data`), uchování vstupu a zobrazení chyb při selhání, a ochranu proti útokům. Aspekt validace je obzvláště důležitý pro **bezpečnost a robustnost** — formuláře zajišťují, že nikdy nedůvěřujete raw vstupu uživatele, zachycují zdeformovaná nebo škodlivá data předtím, než se dostanou do vaší obchodní logiky. **ModelForms** jsou obrovský příspěvek k produktivitě, ztělesnění DRY generováním formulářů přímo z modelů a ukládáním do databáze s minimálním kódem — eliminují boilerplate kód pro mimořádně běžný případ CRUD formulářů. Znalost standardního vzoru view (`is_valid()` + `cleaned_data`), jak přidat vlastní validaci na úrovni polí a mezi poli, ModelForms pro formuláře podporované modelem, a integrace s **CSRF ochranou** je zásadní pro vytváření jakékoliv Django aplikace, která přijímá vstup od uživatele. Formuláře spojují zpracování vstupu, validaci, bezpečnost a vrstvu modelu, což je činí důležitou, často používanou součástí frameworku a klíčovým důvodem, proč je Django tak produktivní pro aplikace s intenzivním zadáváním dat.