使用元資料提供有關程式碼的額外資訊。元資料註解以字元 @ 開頭,後接編譯時常數的參考(例如 deprecated)或常數建構函式的呼叫。

所有 Dart 程式碼都可以使用四個註解:@Deprecated@deprecated@override@pragma。有關使用 @override 的範例,請參閱 擴充類別。以下是使用 @Deprecated 註解的範例

dart
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() {...}
  // ···
}

如果您不想指定訊息,可以使用 @deprecated。但是,我們建議始終使用 @Deprecated 指定訊息。

您可以定義自己的元資料註解。以下是定義需要兩個參數的 @Todo 註解範例

dart
class Todo {
  final String who;
  final String what;

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

以下是使用該 @Todo 註解的範例

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

元資料可以出現在函式庫、類別、typedef、類型參數、建構函式、工廠、函式、欄位、參數或變數宣告之前,以及匯入或匯出指令之前。