Si funksionojnë formularët në Django?

Question

Accepted Answer

Formularët e Django **forms** trajtonin të gjithë ciklin e jetës të dhënave të përdoruesit: renderimin e fushave të formularit HTML, **validimin** e të dhënave të dërguar, dhe konvertimin e tyre në vlera të pastra Python. Ata abstraktojnë punën e mërzitshme dhe të pasigurt të trajtimit manual të dhënash dhe validimit — një veçori e madhe produktiviteti dhe sigurimi. ## Një formular bazik ```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) ``` Secilit fushë formbulari i deklarohen lloji i tij dhe rregullat e validimit. Formbulari mund të përshkruhet si HTML dhe të validojë inputin kundrejt këtyre rregullave. ## Trajtimi i një formular në një view (modeli standard) ```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}) ``` Metodat kryesore: `is_valid()` ekzekuton validimin, dhe në sukses `cleaned_data` ju jep vlerat e sigurta, të validuara, të konvertuara në tip. Në dështim, formbulari ruan inputin dhe grumbullon mesazhet e gabimit. ## ModelForms — formularë nga modelet (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** gjenerohen automatikisht nga fushat e modelit dhe mund të ruhen drejtpërdrejt në bazën e të dhënave — në pajtim me DRY (modeli drejton formularun), duke eleminuar kodin e panevojshëm për formularë CRUD. ## Validimi i personalizuar ```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") ``` ## Renderimi dhe sigurimi ```html ``` Formularët integrohen me mbrojtjen **CSRF** të Django (`{% csrf_token %}`) dhe renderojnë automatikisht fushat me gabimet e tyre të validimit. ## Pse është e rëndësishme Formularët e Django janë një veçori bazë për trajtimin e dhënave të përdoruesit në mënyrë të sigurt dhe produktive — dhe trajtimi i duhur i dhënave është si i përhapur (pothuajse çdo aplikacion ka formularë) ashtu edhe kritik për sigurimin. Kuptimi i formularëve është thelbësor sepse ata abstraktojnë punën e mërzitshme dhe të pasigurt të trajtimit të dhënash: renderimi i fushave HTML, **validimi** i të dhënave kundrejt rregullave, konvertimi i tyre në vlera të pastra Python të tipizuara (`cleaned_data`), ruajtja e inputit dhe shfaqja e gabimeve në dështim, dhe mbrojtje ndaj sulmeve. Aspekti i validimit është veçanërisht i rëndësishëm për **sigurimin dhe qëndrueshmërinë** — formularët sigurohen që asnjëherë nuk e besoni inputin e papërpunuar të përdoruesit, duke kapur të dhëna të deformuara ose të dëmshme para se të arrijnë logjikën tuaj të biznesit. **ModelForms** janë një fitim i madh produktiviteti, në pajtim me DRY duke gjeneruar formularë drejtpërdrejt nga modelet dhe ruajtur në bazën e të dhënave me kod minimal — duke eleminuar kodin e panevojshëm për rastin jashtëzakonisht të zakonshëm të formularëve CRUD. Dija e modelit standard të view (`is_valid()` + `cleaned_data`), si të shtohen validimi i personalizuar në nivel fulle dhe ndër-fulle, ModelForms për formularë të mbështetur nga modeli, dhe integrimi me mbrojtjen **CSRF** është themelore për ndërtimin e çdo aplikacioni Django që pranon inputin e përdoruesit. Formularët lidhin trajtimin e dhënash, validimin, sigurimin, dhe shtresën e modelit, duke i bërë ato një pjesë të rëndësishme, të përdorur shpesh të framework-ut dhe një arsye kyçe pse Django është kaq produktiv për aplikacione të rënda me hyrje të dhënash.