Syntax in Dart

✍️ طريقة الكتابة (Syntax Style) في Dart:

1. ✅ تنظيم الكود داخل الدوال والأقواس

كل كتلة برمجية تُكتب داخل أقواس {}، ويجب تنسيقها بشكل جيد.

void main() {
  print('مرحباً');
}

🟡 لاحظ أن الكود داخل main مكتوب بداخل {} وبتنسيق واضح.

2. ✅ كل تعليمة تنتهي بـ ;

int age = 20;
print(age);

❌ بدون الفاصلة المنقوطة ; سيظهر خطأ في الكود.

3. ✅ المسافات والمسافات البادئة (Indentation)

يفضل ترك 2 أو 4 مسافات قبل كل سطر داخل الكتلة.

void greet() {
  print('أهلاً');
}

4. ✅ كتابة أسماء المتغيرات بطريقة camelCase

String firstName = 'أحمد';
int totalScore = 100;

تبدأ بحرف صغير، وكل كلمة جديدة تبدأ بحرف كبير — وهذه الطريقة الرسمية في Dart.

5. ✅ أسماء الكلاسات بحروف كبيرة PascalCase

class Student {
  String name;
  int age;

  Student(this.name, this.age);
}

6. ✅ ترتيب الكود وتنظيمه

Dart توصي بهذا الترتيب في الكلاس:

1. المتغيرات.
2. الكونستركتر (constructor).
3. الدوال (methods).

class Car {
  String model;
  int year;

  Car(this.model, this.year);

  void start() {
    print('تشغيل السيارة');
  }
}

7. ✅ استخدام الأسطر الفارغة لتسهيل القراءة

void main() {
  print('مرحبا');

  int x = 5;

  print(x * 2);
}

8. ✅ الالتزام بعدم كتابة سطور طويلة جداً

الأسطر الطويلة يتم فصلها:

print(
  'هذا نص طويل جداً نريد كتابته على عدة أسطر لكي يكون سهل القراءة والصيانة'
);

9. ❌ تجنّب التسمية بالعربية أو الرموز

❌ هذا خطأ:

var عدد_الطلاب = 20;
.......................
var studentCount = 20; // هذا الصح

✅ مثال كامل منسق حسب القواعد:

void main() {
  var student = Student('ياسين', 23);
  student.sayHello();
}

class Student {
  String name;
  int age;

  Student(this.name, this.age);

  void sayHello() {
    print('مرحبًا، اسمي $name وعمري $age');
  }
}