Kako delujejo Django obrazci?

Question

Accepted Answer

Django **obrazci** upravljajo celoten življenjski cikel vnosa uporabnika: prikaz HTML polj obrazca, **preverjanje** poslanih podatkov in njihova pretvorba v čiste vrednosti Pythona. Abstrahirajo dolgočasno, napako-nagnjeno ročno obdelavo vnosa in preverjanje — pomembna značilnost za produktivnost in varnost. ## Osnovni obrazec ```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) ``` Vsako polje obrazca deklarira svojo vrsto in pravila za preverjanje. Obrazec se lahko sam izriše kot HTML in preveri vhod glede na ta pravila. ## Obdelava obrazca v prikazu (standardni vzorec) ```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}) ``` Ključne metode: `is_valid()` zagotovi preverjanje, pri uspehu pa `cleaned_data` zagotovi varne, preverjene, v tip pretvorjene vrednosti. Pri neuspehu obrazec obdrži vhod in zbira sporočila o napakah. ## ModelForms — obrazci iz modelov (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** samodejno generirajo obrazec iz polj modela in ga lahko neposredno shranijo v bazo podatkov — jih zato uteleša DRY (model vodi obrazec), kar odpravi šablonsko kodo za CRUD obrazce. ## Lastno preverjanje ```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") ``` ## Prikaz in varnost ```html ``` Obrazci se vključijo v Django-jevo **CSRF zaščito** (`{% csrf_token %}`) in samodejno izrišejo polja s svojimi sporočili o napakah. ## Zakaj je to pomembno Django obrazci so glavna značilnost za varno in produktivno obdelavo vnosa uporabnika — pravilna obdelava vnosa je hkrati vseprisotna (skoraj vsaka aplikacija ima obrazce) in kritična za varnost. Razumevanje obrazcev je bistveno, ker abstrahirajo dolgočasno, napako-nagnjeno delo obdelave vnosa: prikaz HTML polj, **preverjanje** podatkov glede na pravila, njihova pretvorba v čiste vrednosti Pythona s tipom (`cleaned_data`), ohranitev vnosa in prikaz napak ob neuspehu ter zaščita pred napadi. Aspekt preverjanja je posebej pomemben za **varnost in robustnost** — obrazci zagotavljajo, da nikoli ne zaupate neobdelanem vnosu uporabnika, zajemajo napačne ali zlonamernih podatke preden dosežejo vašo poslovno logiko. **ModelForms** so velik dobi za produktivnost, ki uteleša DRY z neposredno generacijo obrazcev iz modelov in shranjevanjem v bazo podatkov z minimalno kodo — odpravijo šablonsko kodo za izredno pogost primer CRUD obrazcev. Znanje standardnega vzorca prikaza (`is_valid()` + `cleaned_data`), kako dodati lastno preverjanje na ravni polja in prečnega polja, ModelForms za obrazce, podprte z modeli, in integracija z **CSRF zaščito** je temelj za gradnjo katere koli Django aplikacije, ki sprejema vnos uporabnika. Obrazci povezujejo obdelavo vnosa, preverjanje, varnost in plast modela, kar jih naredi pomemben, pogosto uporabljen del ogrodja in ključni razlog, zakaj je Django tako produktiven za aplikacije, bogat s podatkovnim vnosom.