Kaip veikia Django formos?

Question

Accepted Answer

Django **formos** valdo visą vartotojo įvesties ciklą: HTML formos laukų renderavimą, pateiktų duomenų **validavimą** ir jų konvertavimą į švarų Python reikšmes. Jos atima nuobodų, klaidoms jautrų rankinį duomenų apdorojimą ir validavimą — tai yra svarbi produktyvumo ir saugumo funkcija. ## Pagrindinė forma ```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) ``` Kiekvienas formos laukas deklaruoja savo tipą ir validavimo taisykles. Forma gali save renderuoti kaip HTML ir validuoti įvestį pagal šias taisykles. ## Formos apdorojimas vaizde (standartinis šablonas) ```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}) ``` Svarbiausiai metodai: `is_valid()` paleide validavimą, o sėkmės atveju `cleaned_data` suteikia saugias, validuotas, tipo-konvertuotas reikšmes. Nepavykus, forma išsaugo įvestį ir surinka klaidų pranešimus. ## ModelForms — formos iš modelių (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** automatiškai generuoja formą iš modelio laukų ir gali tiesiogiai išsaugoti į duomenų bazę — tai reprezentuoja DRY (modelis nustato formą) ir eliminuoja CRUD formų šablonų kodą. ## Pasirinktinis validavimas ```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") ``` ## Renderavimas ir saugumas ```html ``` Formos integruojasi su Django **CSRF apsauga** (`{% csrf_token %}`) ir automatiškai renderuoja laukus su jų validavimo klaidomis. ## Kodėl tai svarbu Django formos yra pagrindinė funkcija, skirta vartotojo įvestiems duomenims saugiai ir produktyviai apdoroti — ir teisingas įvesties apdorojimas yra ir labai dažnas (beveik kiekviena aplikacija turi formas), ir kritiškas saugumui. Svarbu suprasti formas, nes jos atima nuobodų, klaidoms jautrų darbą: HTML laukų renderavimą, duomenų **validavimą** pagal taisykles, konvertavimą į švarų tipizuotą Python reikšmes (`cleaned_data`), įvesties išsaugojimą ir klaidų rodymą nepavykus, ir apsaugą nuo atakų. Validavimo aspektas yra ypač svarbus **saugumui ir patikimumui** — formos užtikrina, kad jūs niekada neperimate ramo vartotojo įvesties, sugaudydamos blogai susitvarkytus ar kenkėjiškus duomenis, kol jie pasiekia jūsų verslo logiką. **ModelForms** yra didžiulis produktyvumo laimėjimas, realizuojantis DRY generuodamos formas tiesiogiai iš modelių ir išsaugant į duomenų bazę su minimaliu kodu — eliminuodamos šablonų kodą itin dažnam CRUD formų atvejui. Žinoti standartinį vaizdo šabloną (`is_valid()` + `cleaned_data`), kaip pridėti pasirinktinį lauko lygio ir tarpkryžminį validavimą, ModelForms modeliais grindžiamoms formoms, ir integracijom su **CSRF apsauga** yra fundamentalu kuriant bet kokią Django aplikaciją, priimančią vartotojo įvestį. Formos susieja įvesties apdorojimą, validavimą, saugumą ir modelio sluoksnį, dėl to jos yra svarbi, dažnai naudojama framework dalį ir pagrindinė priežastis, kodėl Django yra toks produktyvus duomenų įvedimui intensyvuose aplikacijose.