Summary class Null safety

An annotation that provides a short description of a class for use in an index.

Usually the first paragraph of the documentation for a class can be used for this purpose, but on occasion the first paragraph is either too short or too long for use in isolation, without the remainder of the documentation.

/// A famous cat.
/// Instances of this class can hunt small animals.
/// This cat has three legs.
@Category(<String>['Animals', 'Cats'])
@Category(<String>['Cute', 'Pets'])
@Summary('A famous three-legged cat.')
class Pillar extends Cat {
  // ...code...

See also:

  • Category, to help place the class in an index.
  • DocumentationIcon, which is used to give the URL to an image that represents the class.


Summary(String text)
Create an annotation to provide a short description of a class.


hashCode int
The hash code for this object.
read-only, inherited
runtimeType Type
A representation of the runtime type of the object.
read-only, inherited
text String
The text of the summary of the annotated class.


noSuchMethod(Invocation invocation) → dynamic
Invoked when a non-existent method or property is accessed.
toString() String
A string representation of this object.


operator ==(Object other) bool
The equality operator.