Bagaimanakah borang Django berfungsi?

Question

Accepted Answer

**Borang** Django mengendalikan keseluruhan kitaran hayat input pengguna: memaparkan medan borang HTML, **mengesahkan** data yang dihantar, dan menukarnya kepada nilai Python yang bersih. Ia mengabstrak kerja pengendalian input dan pengesahan manual yang membosankan dan terdedah kepada ralat — satu ciri produktiviti dan keselamatan yang utama. ## Borang asas ```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) ``` Setiap medan borang mengisytiharkan jenis dan peraturan pengesahannya. Borang boleh memaparkan dirinya sebagai HTML dan mengesahkan input terhadap peraturan tersebut. ## Mengendalikan borang dalam view (corak 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}) ``` Kaedah utama: `is_valid()` menjalankan pengesahan, dan apabila berjaya `cleaned_data` memberi anda nilai yang selamat, disahkan, dan ditukar jenis. Apabila gagal, borang mengekalkan input dan mengumpul mesej ralat. ## ModelForm — borang daripada 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! ``` **ModelForm** menjana borang secara automatik daripada medan model dan boleh menyimpan terus ke pangkalan data — menjelmakan DRY (model memacu borang), menghapuskan boilerplate untuk borang CRUD. ## Pengesahan tersuai ```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") ``` ## Pemaparan dan keselamatan ```html ``` Borang berintegrasi dengan **perlindungan CSRF** Django (`{% csrf_token %}`) dan memaparkan medan secara automatik bersama ralat pengesahannya. ## Mengapa ia penting Borang Django ialah ciri teras untuk mengendalikan input pengguna dengan selamat dan produktif — dan mengendalikan input dengan betul adalah kedua-dua di mana-mana (hampir setiap aplikasi mempunyai borang) dan kritikal dari segi keselamatan. Memahami borang adalah penting kerana ia mengabstrak kerja pengendalian input yang membosankan dan terdedah kepada ralat: memaparkan medan HTML, **mengesahkan** data terhadap peraturan, menukarnya kepada nilai Python bertaip yang bersih (`cleaned_data`), mengekalkan input dan memaparkan ralat apabila gagal, serta melindungi daripada serangan. Aspek pengesahan amat penting untuk **keselamatan dan keteguhan** — borang memastikan anda tidak pernah mempercayai input pengguna mentah, menangkap data yang cacat atau berniat jahat sebelum ia sampai ke logik perniagaan anda. **ModelForm** ialah kelebihan produktiviti yang besar, menjelmakan DRY dengan menjana borang terus daripada model dan menyimpan ke pangkalan data dengan kod yang minimum — menghapuskan boilerplate untuk kes borang CRUD yang amat biasa. Mengetahui corak view standard (`is_valid()` + `cleaned_data`), cara menambah pengesahan tersuai peringkat medan dan silang medan, ModelForm untuk borang berasaskan model, dan integrasi dengan **perlindungan CSRF** adalah asas untuk membina mana-mana aplikasi Django yang menerima input pengguna. Borang menggabungkan pengendalian input, pengesahan, keselamatan, dan lapisan model, menjadikannya bahagian rangka kerja yang penting dan kerap digunakan serta sebab utama Django begitu produktif untuk aplikasi yang banyak melibatkan kemasukan data.