إتقان نماذج Django لإدخال المستخدم والتحقق من صحتها

تُعد نماذج Django أداة فعّالة للتعامل مع إدخال المستخدم والتحقق من صحة البيانات. فهي تتيح لك إنشاء نماذج يمكنها جمع البيانات ومعالجتها والتحقق من صحتها بطريقة آمنة وسهلة الاستخدام. سترشدك هذه المقالة إلى أساسيات العمل مع نماذج Django وكيفية إتقان استخدامها للتعامل مع إدخال المستخدم والتحقق من صحته بكفاءة.

ما هي نماذج Django؟

نماذج Django هي فئات Python التي تتعامل مع بيانات النماذج. ويمكن استخدامها لعرض نماذج HTML ومعالجة البيانات المرسلة والتحقق من صحة المدخلات. النماذج في Django متكاملة بشكل وثيق مع نماذج Django، مما يسمح بالتحقق من صحة البيانات وحفظها في قاعدة البيانات بسهولة. يمكنك التفكير في نماذج Django كطريقة لأتمتة إنشاء النماذج والتحقق من صحة البيانات ومعالجة الأخطاء.

إنشاء نموذج Django بسيط

لنبدأ بإنشاء نموذج بسيط لجمع بيانات المستخدم. سنقوم بإنشاء نموذج لجمع اسم المستخدم وعنوان بريده الإلكتروني.

from django import forms

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()

في الكود أعلاه، قمنا بإنشاء نموذج يسمى ContactForm يتضمن حقلين: name وemail. يُستخدم CharField لإدخال النص، ويضمن EmailField أن يكون الإدخال عنوان بريد إلكتروني صالحًا.

عرض النماذج في القوالب

بمجرد تعريف النموذج، ستحتاج إلى عرضه في قالب. يمكنك عرض نموذج في Django باستخدام علامة القالب {{ form }}، والتي ستولد HTML تلقائيًا لكل حقل في النموذج.

{% load static %}

<form method="POST" action="">
    {% csrf_token %}
    {{ form.as_p }}
    Submit</button>
</form>

في رمز القالب هذا، نستخدم form.as_p لعرض حقول النموذج داخل علامات الفقرة. يتم استخدام {% csrf_token %} لتضمين رمز CSRF لأغراض الأمان عند التعامل مع عمليات إرسال النماذج.

التحقق من صحة بيانات النموذج

يعد التحقق جزءًا أساسيًا من أي نموذج. توفر نماذج Django التحقق التلقائي بناءً على أنواع الحقول، ولكن يمكنك أيضًا إضافة منطق تحقق مخصص لضمان سلامة البيانات.

التحقق من صحة الحقل المدمج

تتضمن حقول Django ميزة التحقق المضمنة. على سبيل المثال، سيتحقق حقل EmailField تلقائيًا مما إذا كان الإدخال عنوان بريد إلكتروني صالحًا. إذا كان الإدخال غير صالح، فسيعيد النموذج رسالة خطأ.

طرق التحقق المخصصة

يمكنك أيضًا إنشاء طرق تحقق مخصصة لتطبيق قواعد تحقق أكثر تعقيدًا. إليك مثال حيث نتحقق من أن نطاق البريد الإلكتروني من شركة معينة.

class ContactForm(forms.Form):
    name = forms.CharField(max_length=100)
    email = forms.EmailField()

    def clean_email(self):
        email = self.cleaned_data['email']
        if '@company.com' not in email:
            raise forms.ValidationError("Email must be from company.com domain.")
        return email

في الكود أعلاه، قمنا بتعريف طريقة clean_email للتحقق مما إذا كان البريد الإلكتروني يحتوي على '@company.com'. إذا لم يكن كذلك، فسيتم رفع خطأ ValidationError، وسيعرض النموذج رسالة خطأ.

التعامل مع نموذج الإرسال

بمجرد إرسال النموذج، يمكنك الوصول إلى بيانات النموذج في وظيفة العرض الخاصة بك. إليك كيفية معالجة إرسال النموذج:

from django.shortcuts import render
from .forms import ContactForm

def contact_view(request):
    if request.method == 'POST':
        form = ContactForm(request.POST)
        if form.is_valid():
            # Process the data, e.g., save to the database or send email
            name = form.cleaned_data['name']
            email = form.cleaned_data['email']
            # Handle the data as needed
            return render(request, 'success.html', {'name': name})
    else:
        form = ContactForm()

    return render(request, 'contact.html', {'form': form})

في هذا المثال، عند إرسال النموذج، نتحقق مما إذا كان النموذج صالحًا باستخدام form.is_valid(). إذا كان النموذج صالحًا، نصل إلى البيانات المنظفة ونعالجها. إذا لم يكن كذلك، فسيعرض Django تلقائيًا رسائل الخطأ المناسبة للمستخدم.

عرض أخطاء النموذج

يضيف Django رسائل الخطأ تلقائيًا إلى حقول النموذج غير الصالحة. يمكنك عرض رسائل الخطأ هذه في القالب الخاص بك لتقديم ملاحظات للمستخدم. إليك مثال:

{% if form.errors %}

{% for field in form %} {% for error in field.errors %}
• {{ خطأ }}
{% endfor %} {% endfor %}

{% endif %}

في هذا الكود، نتحقق من وجود أي أخطاء في النموذج وننتقل عبر كل حقل نموذج لعرض رسائل الخطأ المقابلة.

استخدام النماذج مع النماذج

يتيح لك Django أيضًا ربط النماذج بالنماذج بسهولة باستخدام ModelForm. يقوم ModelForm تلقائيًا بإنشاء حقول النماذج استنادًا إلى حقول النموذج، مما يبسط عملية إنشاء النماذج لنماذج قاعدة البيانات.

إنشاء نموذج

فيما يلي مثال لاستخدام ModelForm لإنشاء نموذج يعتمد على نموذج:

from django.db import models
from django import forms

class Contact(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()

class ContactForm(forms.ModelForm):
    class Meta:
        model = Contact
        fields = ['name', 'email']

في هذا الكود، لدينا نموذج Contact مع الحقلين name وemail. نموذج ContactForm هو نموذج ModelForm يقوم تلقائيًا بإنشاء حقول نموذج استنادًا إلى نموذج Contact.

خاتمة

يتيح لك إتقان نماذج Django التعامل مع إدخال المستخدم بكفاءة وأمان. من خلال الاستفادة من التحقق المدمج وطرق التحقق المخصصة وتكامل النماذج، يمكنك ضمان تجربة مستخدم سلسة والحفاظ على سلامة البيانات في تطبيقات Django الخاصة بك. تدرب على إنشاء النماذج واستخدامها لتصبح أكثر كفاءة في التعامل مع أنواع مختلفة من إدخال المستخدم.