زبان برنامه‌نویسی

چیت‌شیت Dart

راهنمای Dart برای تعریف نوع، collection، توابع، null safety و عملیات async. nullable بودن را در نوع‌ها بیان کنید و از force unwrap بی‌دلیل بپرهیزید. مدل immutable رفتار قابل‌پیش‌بینی‌تری دارد. collectionهای typed خطاهای نوع را زود آشکار می‌کنند. switch expression برای حالت‌های محدود، نتیجهٔ exhaustive و قابل‌فهم می‌سازد. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.

NOVIN SKILLS / DIGITAL STUDIO

Null-aware operators

?. و ?? دسترسی و مقدار پیش‌فرض را بدون شاخهٔ اضافی می‌سازند.

1String displayName(User? user) {2  final name = user?.name.trim();3  return name == null || name.isEmpty ? 'Guest' : name;4}

Named parameters

پارامترهای نام‌دار فراخوانی را روشن‌تر می‌کنند.

1String greet({required String name, String prefix = 'Hello'}) {2  return '$prefix, $name';3}

Class و constructor

constructor نام‌دار می‌تواند ساخت نمونه را معنایی‌تر کند.

1class User {2  const User({required this.id, required this.name});34  final int id;5  final String name;6}

Collection if و spread

collection literalها شرط و گسترش مجموعه را پشتیبانی می‌کنند.

1final visibleItems = [2  ...featuredItems,3  if (showRecent) ...recentItems,4];

Map و where/map

زنجیرهٔ iterable را برای فیلتر و نگاشت داده استفاده کنید.

1final names = users2    .where((user) => user.isActive)3    .map((user) => user.name)4    .toList();

Switch expression

switch expression در حالت‌های enum باید همهٔ شاخه‌ها را پوشش دهد.

1final label = switch (status) {2  Status.ready => 'Ready',3  Status.loading => 'Loading',4  Status.failed => 'Failed',5};

Future و await

خطای Future در try/catch فراخوانندهٔ async قابل‌رسیدگی است.

1Future<User> loadUser(int id) async {2  final response = await client.get('/users/$id');3  return User.fromJson(response.data);4}

Future.wait

کارهای مستقل را هم‌زمان اجرا و پس از تکمیل جمع‌آوری کنید.

1final results = await Future.wait([2  loadProfile(userId),3  loadPreferences(userId),4]);

Stream subscription

subscription را در پایان lifecycle لغو کنید.

1late final StreamSubscription<int> subscription;23void start(Stream<int> values) {4  subscription = values.listen(handleValue, onError: reportError);5}67Future<void> stop() => subscription.cancel();

برای استفاده در پروژه

نکات کلیدی

۱
متغیر قابل‌تغییر را با var یا نوع صریح و مقدار ثابت را با final بسازید.
۲
مقدار کامپایل‌تایم ثابت را با const تعریف کنید.
۳
نوع nullable را با ? نشان دهید و پیش از مصرف null را کنترل کنید.
۴
لیست، set و map را با نوع عناصر مشخص تعریف کنید.
۵
تابع پیکانی کوتاه: int double(int value) => value * 2;
۶
پارامترهای نام‌دار را برای فراخوانی خواناتر به‌کار ببرید.
۷
عملیات ناهمگام را با Future<T>، async و await بنویسید.
۸
جریان داده را با Stream<T> مدل و subscription را مدیریت کنید.
۹
الگوی sealed و switch exhaustive را برای حالت‌های محدود به‌کار ببرید.
۱۰
قالب‌بندی را با dart format و تحلیل را با dart analyze اجرا کنید.
۱۱
null safety را در نوع‌ها صریح کنید؛ ! فقط وقتی استفاده شود که non-null بودن واقعاً تضمین شده است.
۱۲
Future را برای یک نتیجهٔ ناهمگام و Stream را برای دنبالهٔ چند رویداد انتخاب کنید و subscription را مدیریت کنید.