Django Academy · درس

‏is_valid وcleaned_data

تحقّق من الإدخال واقرأ القيم المنقّحة

‏is_valid وcleaned_data درس مجاني في Django Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Django Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Django Academy 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

Bind Data First

To validate, create a bound form by passing the submitted data into it. Only bound forms can be validated.

form = ContactForm(request.POST)

Call is_valid()

is_valid() runs every field validation and returns True only if all of them pass. It triggers the whole cleaning process.

if form.is_valid():
    handle(form)

cleaned_data Appears

After is_valid() returns True, Django fills cleaned_data, a dict of validated, type-converted values ready to use.

name = form.cleaned_data["name"]

Values Are Converted

Cleaning converts types too. An IntegerField gives you a real int, and a DateField gives you a Python date, not raw strings.

age = form.cleaned_data["age"]  # int

Errors Collect Automatically

If validation fails, the messages land in form.errors, keyed by field name so you can show each problem clearly.

if not form.is_valid():
    print(form.errors)

Field-Level clean Methods

Add a method named clean_field to validate one field and return its cleaned value. Raise ValidationError to reject it.

def clean_name(self):
    name = self.cleaned_data["name"]
    return name.strip()

Raise ValidationError

Inside a clean method, raise ValidationError with a message to reject the value and attach an error to that field.

if "@" not in email:
    raise forms.ValidationError("Bad email")

Form-Wide clean()

Override clean() to validate fields against each other, like confirming two passwords match across the whole form.

def clean(self):
    cleaned = super().clean()
    return cleaned

Cross-Field Checks

In clean() you can read several cleaned_data keys and raise an error when their combination is invalid.

if start > end:
    raise forms.ValidationError("Bad range")

The Cleaning Order

Django runs field cleaning first, then your form-wide clean(). So clean() can safely rely on already-validated field values.

Use cleaned_data Safely

Always read input from cleaned_data, never from request.POST. Only cleaned_data holds validated, converted, trusted values.

email = form.cleaned_data["email"]

Quick Check

Test your grip on validation.

Recap

Bind data, call is_valid(), then read trusted values from cleaned_data. Use clean methods to add your own rules. ✅

الأسئلة الشائعة

هل درس «‏is_valid وcleaned_data» مجاني؟

نعم — نص درس «‏is_valid وcleaned_data» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Django Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Django Academy 4 دروس في المجموع.

ماذا ستتعلم في «‏is_valid وcleaned_data»؟

تحقّق من الإدخال واقرأ القيم المنقّحة تتمرن على Django Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Django Academy؟

لا تُشترط خبرة سابقة. Django Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «‏is_valid وcleaned_data»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Django Academy هذا؟

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

جميع الدروس في هذه الدورة

← العودة إلى Django Academy