Dart 語法預覽

Dart 支持單行注釋、多行注釋和 文檔注釋。

Single-line comments 單行注釋以 // 開始。 // 后面的一行內容 為 Dart 代碼注釋。

main() {
  // TODO: refactor into an AbstractLlamaGreetingFactory?
  print('Welcome to my Llama farm!');
}

Multi-line comments

多行注釋以 /* 開始, */ 結尾。 多行注釋 可以 嵌套。

main() {
  /*
   * This is a lot of work. Consider raising chickens.

  Llama larry = new Llama();
  larry.feed();
  larry.exercise();
  larry.clean();
   */
}

Documentation comments

文檔注釋可以使用 /// 開始, 也可以使用 /** 開始 并以 */ 結束。

在文檔注釋內, Dart 編譯器忽略除了中括號以外的內容。 使用中括號可以引用 classes、 methods、 fields、 top-level variables、 functions、 和 parameters。中括號里面的名字使用 當前注釋出現地方的語法范圍查找對應的成員。

下面是一個引用其他類和成員 的文檔注釋:

/// A domesticated South American camelid (Lama glama).
///
/// Andean cultures have used llamas as meat and pack
/// animals since pre-Hispanic times.
class Llama {
  String name;

  /// Feeds your llama [Food].
  ///
  /// The typical llama eats one bale of hay per week.
  void feed(Food food) {
    // ...
  }

  /// Exercises your llama with an [activity] for
  /// [timeLimit] minutes.
  void exercise(Activity activity, int timeLimit) {
    // ...
  }
}

在生成的文檔中,[Food] 變為一個連接 到 Food 類 API 文檔的鏈接。

使用 SDK 中的 文檔生成工具可以解析文檔并生成 HTML 網頁。 關于生成的文檔示例,請參考 Dart API 文檔。 關于如何 組織文檔的建議,請參考 Dart 文檔注釋指南。

Summary(總結) 該頁內容介紹了常見的 Dart 語言特性。 還有更多特性有待實現,但是新的特性不會破壞已有的代碼。 更多信息請參考 Dart 語言規范 和 Effective Dart。

要了解 Dart 核心庫的詳情,請參考 Dart 核心庫預覽。


所屬標簽

無標簽

官方入門指南

Flutter官方發布的入門指導,包括了如何在不同的平臺(Windows, Mac, Linux)上搭建開發環境,以及一些入門級的指導,以便您從零開始進入Flutter的世界,同時,一些Flutter的框架API,也是您開發時必不可少的工具書。

從這里進入


25选5玩法中奖