Flutter 颤振和省道文档中的@macro注释是什么

当我阅读源代码时，我经常看到这样的内容（来自）：

//{@macro flatter.widgets.editableText.keyboardType}
最终文本输入类型键盘类型；

@宏

是什么意思

---

我找到了答案，所以我在下面发布了一个自我回答问答。

a

@macro

是一种插入其他地方编写的文档的方法。这样，您就不必维护重复的文档

@macro

后面的字符串是模板的名称，其中包括要插入的文档。因此，在示例中：

//{@macro flatter.widgets.editableText.keyboardType}
最终文本输入类型键盘类型；

模板名称为

flatter.widgets.editableText.keyboardType

。如果您转到的源代码，您将找到包含文档文本的模板：

//{@template flatter.widgets.editableText.keyboardType}
///用于编辑文本的键盘类型。
///
///如果[maxLines]为1，则默认为[TextInputType.text]
///[TextInputType.multiline]否则。
///{@endtemplate}
最终文本输入类型键盘类型；

注释

@template

启动模板并后跟其名称

@endtemplate

完成它

查看

EditableText.keyboardType

和

TextField.keyboardType

的文档时，可以看到它们完全相同：

阅读更多的文章