Category class

A category with which to annotate a class, for documentation purposes.

A category is usually represented as a section and a subsection, each of which is a string. The engineering team that owns the library to which the class belongs defines the categories used for classes in that library. For example, the Flutter engineering team has defined categories like "Basic/Buttons" and "Material Design/Buttons" for Flutter widgets.

A class can have multiple categories.

/// A copper coffee pot, as desired by Ben Turpin.
/// ...documentation...
@Category(<String>['Pots', 'Coffee'])
@Category(<String>['Copper', 'Cookware'])
@Summary('A proper cup of coffee is made in a proper copper coffee pot.')
class CopperCoffeePot {
  // ...code...

See also:

  • DocumentationIcon, which is used to give the URL to an image that represents the class.
  • Summary, which is used to provide a one-line description of a class that overrides the inline documentations' own description.


Category(List<String> sections)
Create an annotation to provide a categorization of a class.


hashCode int
The hash code for this object.
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
sections List<String>
The strings the correspond to the section and subsection of the category represented by this object.


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


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