البرمجة

تفاعل فعّال: دليل شامل لاستخدام مكتبة WTForms في إطار Flask

26/01/2024
6 2 دقائق

في عالم تطوير تطبيقات الويب باستخدام إطار العمل Flask، تصبح مكتبة WTForms أحد الأدوات الأساسية والقوية لتسهيل وتنظيم عمليات التحقق والتحكم في الإدخالات المستخدمين. يُعتبر التفاعل مع حقول النصوص والأعداد والتواريخ ضمن هذه المكتبة جزءًا حيويًا من عملية بناء النماذج والتفاعل مع البيانات.

تأخذ WTForms مفهوم النموذج إلى مستوى آخر، حيث تمكِّن المطوِّرين من تحديد وتخصيص حقول الإدخال بطريقة مرنة وسهلة. ابدأ بتكوين نموذجك باستيراد الطبقة Form من WTForms، وقم بتحديد حقولك باستخدام مجموعة متنوعة من الأنواع المدعومة.

عند التعامل مع حقول النصوص، يمكنك استخدام StringField لتمثيل نصوص الإدخال. قد تحتاج إلى تحديد أي خصائص إضافية تتعلق بالصحة والتحقق من البيانات. على سبيل المثال:

python
from wtforms import Form, StringField, IntegerField, DateField

class MyForm(Form):
    text_field = StringField('نص')
    number_field = IntegerField('رقم')
    date_field = DateField('تاريخ')

يُمكنك أيضًا إضافة تحقق إضافي باستخدام مكتبة validators المدمجة:

python
from wtforms import validators

class MyForm(Form):
    text_field = StringField('نص', validators=[validators.Length(min=4, max=25)])
    number_field = IntegerField('رقم', validators=[validators.NumberRange(min=1, max=100)])
    date_field = DateField('تاريخ', format='%Y-%m-%d', validators=[validators.InputRequired()])

في هذا السياق، يُلاحظ أنّه يمكن تخصيص تنسيق التاريخ باستخدام خاصية format، ويُمكنك أيضًا تحديد قواعد التحقق من البيانات باستخدام validators المناسبة.

عندما تقوم بتقديم النموذج في طلب Flask، يُمكنك الوصول إلى البيانات المدخلة والتحقق من صحتها باستخدام request.form و form.validate() على التوالي. إليك مثال على كيفية تحقق النموذج في العرض:

python
from flask import Flask, render_template, request

app = Flask(__name__)

@app.route('/my_form', methods=['POST'])
def my_form():
    form = MyForm(request.form)
    if form.validate():
        # يتم تنفيذ العمليات المطلوبة عندما يكون النموذج صحيحًا
        return "تم التحقق بنجاح!"
    else:
        # يتم التعامل مع الأخطاء في حالة عدم صحة النموذج
        return render_template('form_errors.html', errors=form.errors)

if __name__ == '__main__':
    app.run(debug=True)

تجنب الاقتصار على استخدام WTForms للنماذج البسيطة فقط، حيث يمكنك استكشاف واستخدام ميزاتها المتقدمة مثل حقول التحقق والتعليمات البرمجية الخاصة بالتحقق والتخصيص.

باستخدام هذه الإرشادات، ستكون قادرًا على تسهيل التفاعل بين تطبيق Flask الخاص بك وبين البيانات التي يتم إدخالها من قبل المستخدمين بشكل فعّال وآمن.

المزيد من المعلومات

عند العمل مع مكتبة WTForms ضمن إطار Flask، يمكن أيضًا التفكير في تخصيص المظهر البصري للنموذج. يُمكنك استخدام قوالب Jinja2 لتصميم واجهة المستخدم الخاصة بالنموذج وتخصيص طريقة عرض الحقول والرسائل الخطأ.

استفد من قوالب Jinja2 لإظهار النموذج بشكل ملائم داخل صفحات ويب Flask الخاصة بك. يمكنك تضمين الحقول والرسائل بسهولة باستخدام تركيبات Jinja2، كما هو موضح في المثال التالي:

html
html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>نموذج Flask-WTFormstitle>
head>
<body>
    <h1>نموذج Flask-WTFormsh1>
    <form method="post" action="{{ url_for('my_form') }}">
        {{ form.hidden_tag() }}
        
        <label for="{{ form.text_field.id }}">{{ form.text_field.label.text }}label>
        {{ form.text_field() }}
        {% if form.text_field.errors %}
            <ul class="errors">
                {% for error in form.text_field.errors %}
                    <li>{{ error }}li>
                {% endfor %}
            ul>
        {% endif %}

        <label for="{{ form.number_field.id }}">{{ form.number_field.label.text }}label>
        {{ form.number_field() }}
        {% if form.number_field.errors %}
            <ul class="errors">
                {% for error in form.number_field.errors %}
                    <li>{{ error }}li>
                {% endfor %}
            ul>
        {% endif %}

        <label for="{{ form.date_field.id }}">{{ form.date_field.label.text }}label>
        {{ form.date_field() }}
        {% if form.date_field.errors %}
            <ul class="errors">
                {% for error in form.date_field.errors %}
                    <li>{{ error }}li>
                {% endfor %}
            ul>
        {% endif %}

        <button type="submit">إرسالbutton>
    form>
body>
html>

في هذا السياق، يتم عرض الحقول والرسائل بشكل منظم داخل النموذج. يُفضل تخصيص الأسلوب البصري لتناسب تصميم موقع الويب الخاص بك.

كما يُنصح بتضمين معالج Flask-WTF CSRF بشكل منفصل إذا كنت تستخدم النماذج داخل نموذج WTForms. يمكنك تضمينه في تطبيقك بهذه الطريقة:

python
from flask_wtf.csrf import CSRFProtect

csrf = CSRFProtect(app)

ويمكنك ثم استخدام {{ form.csrf_token() }} داخل نموذجك لتضمين حقل CSRF Token بشكل صحيح.

هذا التفاعل بين Flask و WTForms يوفر لك ليس فقط واجهة مستخدم فعّالة وجذابة بل أيضًا عمليات تحقق وتنظيم بيانات المستخدم بشكل دقيق وآمن.

الوسوم
26/01/2024
6 2 دقائق
جميع الحقوق محفوظة مركز حلول تكنولوجيا المعلومات
زر الذهاب إلى الأعلى