-
Notifications
You must be signed in to change notification settings - Fork 240
@alias
Synopsis:
@alias prefix.name
Defines aliases for the class name.
Example:
/**
* @class Ext.grid.Panel
* The grid of data.
* @alias widget.grid
* @alias widget.gridpanel
*/There are 3 recognized prefixes: widget, plugin, feature. These are mapped to xtype, ptype and ftype respectively.
This means the above code will result in xtype: grid, gridpanel in generated documentation. Similarly @alias feature.foo will result in ftype: foo, and @alias plugin.bar in ptype: bar. For these three things shortcut tags are also available: @xtype, @ptype, @ftype.
Any other prefixes may also be used, but for them no mapping is done. So @alias store.json will result in store: json.
This tag is auto-detected when class comment is right above Ext.define which contains alias:. The following code is equivalent of the above one:
/**
* The grid of data.
*/
Ext.define("Ext.panel.Table", {
alias: [
"widget.grid",
"widget.gridpanel"
]
});Otherwise the auto-detection behaves just like with @alternateClassName tag.
For backwards compatibility @alias can be used for copying documentation from another member. See @inheritdoc for details.