فراداده (متادیتا)

از متادیتا برای دادن اطلاعات بیشتر در مورد کد خود استفاده کنید. حاشیه نویسی ابرداده با کاراکتر @ شروع می شود و به دنبال آن ارجاع به یک ثابت زمان کامپایل (مانند منسوخ شده) یا فراخوانی به یک سازنده ثابت می آید.

چهار حاشیه نویسی برای همه کدهای دارت موجود است: @Deprecated، @deprecated، @override، و @pragma. . در اینجا نمونه ای از استفاده از حاشیه نویسی Deprecated@ آورده شده است:

class Television {
  /// Use [turnOn] to turn the power on instead.
  @Deprecated('Use turnOn instead')
  void activate() {
    turnOn();
  }

  /// Turns the TV's power on.
  void turnOn() {...}
  // ···
}

شما می توانید حاشیه نویسی ابرداده خود را تعریف کنید. در اینجا مثالی از تعریف یک حاشیه نویسی @Todo است که دو آرگومان دارد:

class Todo {
  final String who;
  final String what;

  const Todo(this.who, this.what);
}

و در اینجا نمونه ای از استفاده از حاشیه نویسی @Todo آورده شده است:

@Todo('Dash', 'Implement this function')
void doSomething() {
  print('Do something');
}

ابرداده می تواند قبل از یک کتابخانه، کلاس، typedef، پارامتر نوع، سازنده، factory، تابع، فیلد، پارامتر یا اعلان متغیر و قبل از یک دستورالعمل import یا export ظاهر شود.

@override
وقتی از کلاس دیگری ارث می‌برید و می‌خواهید روشی را تغییر دهید یا لغو کنید، از این حاشیه‌نویسی برای روشن کردن آن استفاده می‌کنید.

@pragma
هدف: این یکی کمی پیشرفته تر است. این به کامپایلر Dart می گوید که چگونه بخش های خاصی از کد را مدیریت کند، مانند اطمینان از اینکه برخی از کدها در طول بهینه سازی حذف نمی شوند.