🌟 مقدمة تحفيزية:

“مرحباً بك يا مهندس الأنظمة ! تخيل أنك تمتلك مصنعاً ، بدلاً من أن تقوم بصناعة كل قطعة يدوياً في كل مرة ، أنت تصنع ‘قالبًا’ واحداً ينتج لك آلاف القطع بضغطة زر . في البرمجة ، هذا القالب يسمى الدالة (Function) . هي مجموعة من الأوامر نجمعها معاً ونعطيها اسماً ، لنقوم باستدعائها في أي وقت وفي أي مكان في الموقع دون إعادة كتابتها .

اليوم في أكاديمية قياوي ، ستتعلم كيف تكتب كوداً ذكياً ، نظيفاً ، ومحترفاً  !”

🏗️ 1 . المفهوم : ما هي الـ Function ؟

الدالة هي “مهمة محددة” نجهزها مسبقاً .

مثال : دالة لحساب الخصم ، دالة لإرسال بريد إلكتروني ، أو دالة لتغيير لون الموقع .

💻 2 . كيف نبني دالة ؟ (Syntax)

إليك الطريقة الاحترافية لكتابة الدالة في JavaScript :

  JavaScript

// 1. تعريف الدالة (بناء المصنع)
function sayWelcome(name) {
    console.log("أهلاً بك يا " + name + " في المستوى المتقدم!");
}

// 2. استدعاء الدالة (تشغيل المصنع)
sayWelcome("ميمون"); 
sayWelcome("أحمد");

⚖️  3  . تطبيق عملي (قانوني وتقني)

لنصنع دالة تحسب تكلفة الاستشارة القانونية في موقعك بناءً على عدد الساعات :   JavaScript

function calculateConsultation(hours) {
    let pricePerHour = 300; // سعر الساعة بالدرهم
    let total = hours * pricePerHour;
    return "إجمالي تكلفة الاستشارة هو: " + total + " درهم";
}

// استدعاء الدالة لزائر طلب ساعتين
alert(calculateConsultation(2));

💡 لماذا هذا الدرس هو ذروة الاحتراف ؟

في موقع qiyaouiacademy.com ، الدوال هي التي تدير العمليات المعقدة :

1 •    التنظيم : بدلاً من كتابة كود طويل في كل صفحة ، نضع الدوال في ملف واحد ونستدعيها .

2 •    التحديث السهل : إذا أردت تغيير سعر الاستشارة ، ستغيره في “دالة واحدة” فقط ، وسيتغير في كل الموقع تلقائياً !

3  •     التفاعل : الدوال هي التي تعمل عندما يضغط الطالب على أزرار الموقع .

🎯 تحدي المحترفين :

“يا بطل ، قم ببناء دالة تسمى checkGrade . تأخذ هذه الدالة درجة الطالب كمدخل ، وتخبره ‘ناجح’ إذا كانت الدرجة 50 فأكثر ، و ‘راسب’ إذا كانت أقل . هل يمكنك دمج هذا مع درس الشروط (If) الذي تعلمناه سابقاً ؟”

للتوضيح : 

في هذا الدرس سنتعلم مفهوم الدوال في JavaScript . الدوال تشبه آلة صغيرة داخل البرنامج تقوم بتنفيذ مهمة محددة عند استدعائها . سيتعلم الطالب كيفية إنشاء دالة واستخدامها لتنفيذ الأوامر عند الضغط على زر أو عند حدوث حدث داخل الصفحة .

في البرامج الكبيرة نحتاج أحياناً إلى تنفيذ نفس المهمة عدة مرات .

مثلاً : حساب مجموع رقمين  ،  إظهار رسالة  ،  تغيير لون عنصر في الصفحة  ،  بدل كتابة الكود كل مرة ، ننشئ دالة . في لغة JavaScript ، تسمى هذه الدالة Function . يمكن تشبيهها بـ آلة صغيرة داخل البرنامج .

🖼 فكرة الدالة  :

الفكرة  : مدخلات → معالجة → نتيجة

🟢 الشكل الأساسي للدالة

 JavaScript

function myFunction() {

console.log("مرحبا بكم");

}

هذه الدالة لا تعمل إلا عندما نستدعيها .

🟢 استدعاء الدالة  

JavaScript

myFunction();

النتيجة: مرحبا بكم

🟢 مثال داخل صفحة ويب

HTML

<button onclick="sayHello()">اضغط هنا</button>

<script>

function sayHello(){

alert("مرحبا بك في Qiyaoui Academy");

}

</script>

🟢 النتيجة عند الضغط على الزر تظهر رسالة :

           مرحبا بك في Qiyaoui Academy

🟢 دالة مع مدخلات (Parameters)  

  JAVASCRIPT

function greet(name){

console.log("مرحبا " + name);

}

greet("Ali");

النتيجة  : مرحبا Ali 

🧠 فكرة مهمة

الدوال تساعد على : ✔ تنظيم الكود  ،  ✔ إعادة استعمال الكود  ،  ✔ بناء برامج كبيرة بسهولة .

🏆 تمرين للطلاب أنشئ دالة اسمها  :

              showMessage

وعند استدعائها تظهر الرسالة :                   مرحبا بك في موقعنا