meta library

用于元数据注释的常量.

另请参见dart:core库中的@deprecated@override .

注释提供了语义信息,工具可以使用这些信息来提供更好的用户体验. 例如,IDE可能不会自动完成标记为@deprecated的函数的名称,或者可能会以不同的方式显示该函数的名称.

有关安装和导入该库的信息,请参见pub.dev上meta包 . 有关使用注释的示例,请参阅语言导览中的元数据 .

Classes

Immutable
用于注释类. [...]
Required
用于注释方法或函数f的命名参数p . [...]

Constants

alwaysThrows → const _AlwaysThrows
用于注释函数f . 表示f总是抛出异常. 在类继承中,任何覆盖f函数也应遵守此协定. [...]
const _AlwaysThrows()
checked → const _Checked
用于注释覆盖另一个方法的实例方法的参数. [...]
const _Checked()
experimental → const _Experimental
用于对库或库公共接口一部分的任何声明(例如顶级成员,类成员和函数参数)进行注释,以指示带注释的API是实验性的,可以在任何时候删除或更改-time而不更新包含软件包的版本,尽管事实上这将是一个重大更改. [...]
const _Experimental()
factory → const _Factory
用于注释实例或静态方法m . 指示m必须是抽象的,或者必须返回新分配的对象或null . 另外,实现或覆盖m每个方法都使用相同的注释进行隐式注释. [...]
const _Factory()
immutable → const Immutable
用于注释类C 表示C和所有亚型C必须是不可变的. [...]
const Immutable ()
isTest → const _IsTest
用于注释运行单个测试的测试框架功能. [...]
const _IsTest()
isTestGroup → const _IsTestGroup
用于注释运行一组测试的测试框架功能. [...]
const _IsTestGroup()
literal → const _Literal
用于注释const构造函数c . 指示对构造函数的任何调用都必须使用关键字const除非构造const一个或多个参数不是编译时常量. [...]
const _Literal()
mustCallSuper → const _MustCallSuper
用于注释实例方法m . 指示重写m的方法的每次调用也必须调用m . 另外,重写m每个方法都使用相同的注释进行隐式注释. [...]
const _MustCallSuper()
nonVirtual → const _NonVirtual
用于注释类C或mixin M的实例成员(方法,getter,setter,运算符或字段) m . 表明m不应该在延伸或混入任何类覆盖CM . [...]
const _NonVirtual()
optionalTypeArgs → const _OptionalTypeArgs
用于注释类,mixin或扩展声明C 指示在C上声明的任何类型参数都将被视为可选. 分析器和linter等工具可以使用此信息来抑制警告,否则这些警告将要求提供C上的类型参数.
const _OptionalTypeArgs()
protected → const _Protected
用于注释一个实例成员(方法,吸气剂,设置器,操作员或场) m类中的C . 如果注释在字段上,则适用于该字段引起的getter和setter(如果适用). 指示m仅应从C实例方法或直接或间接在C中扩展,实现或混合的类调用. 此外,指示仅应this显式或隐式调用m . [...]
const _Protected()
required → const Required
用于注释方法或函数f的命名参数p . 指示对f每次调用都必须包含一个与p对应的参数,尽管p否则将是一个可选参数. [...]
const Required ()
sealed → const _Sealed
Annotation marking a class as not allowed as a super-type. [...]
const _Sealed()
virtual → const _Virtual
用于注释允许在"强模式"下覆盖的字段. [...]
const _Virtual()
visibleForOverriding → const _VisibleForOverriding
用于注释已公开的实例成员,以便可以重写它,但不应从定义库外部对其进行引用. [...]
const _VisibleForOverriding()
visibleForTesting → const _VisibleForTesting
用来声明声明的声明已公开,因此使代码可测试的程度比其他必要可见. [...]
const _VisibleForTesting()