我如何创建DartDoc宏/模板的Dart和颤振？

Question

在整个颤振回购过程中，我见过类似于以下片段的片段：

/// {@macro flutter.widgets.editableText.readOnly}

在IDE和呈现的Dart文档中，然后是如图所示

是否可以更改文本。 当此设置为true时，任何快捷方式或键盘操作都无法修改文本。文本仍然可以选择。 默认为false。不能是空的。

而且它往往远远超出了这个基本的情况。

Answer 1

您可以创建模板，并使用dartdoc作为宏使用，这是Flutter附带的默认API文档包。

只需在文档中的任何地方定义一个@template：

/// {@template template_name}
/// Some shared docs
/// {@endtemplate}

现在，您可以在其他任何地方重用它：

/// Some comment
/// {@macro template_name}
/// More comments

了解更多。