dart api劃掉變量

Question

在大多數Dart文檔頁面中，某些變量和函數被劃掉。像在https://api.dartlang.org/1.14.2/dart-js/dart-js-library.html

這是什麼意思？

Answer 1

它標誌着類，功能，性能等爲deprecated

在飛鏢，註釋用作棄用標記的東西。注意this class上的文檔註釋。

Answer 2

飛鏢metadata可以添加到類，字段，庫聲明，參數...作爲註釋。

@Deprecated('some reason') 
class SomeClass { 
    String someField; 
    int otherField; 

    SomeClass({ 
     this.someField, 
     @Deprecated('don\'t use this anymore") this.otherField}); 
} 

是這樣的註釋和一些工具，如飛鏢分析儀和dartdoc使用這些信息來產生警告（分析）或其他視覺線索，一些API仍然存在，但應避免使用，因爲它計劃最終要去除。