-
Notifications
You must be signed in to change notification settings - Fork 240
@alternateClassName
nene edited this page Aug 9, 2012
·
6 revisions
Synopsis:
@alternateClassName OtherClassName
Defines an alternate name for class. To be used inside class documentation.
Example:
/**
* @class Ext.panel.Panel
* A simple panel class.
* @alternateClassName Ext.Panel
* @alternateClassName XPanel
*/
This tag is auto-detected when class comment is right above Ext.define
which contains alternateClassName:
. The following code is equivalent of the above one:
/**
* A simple panel class.
*/
Ext.define("Ext.panel.Panel", {
alternateClassName: ["Ext.Panel", "XPanel"]
});
Note: when using @alternateClassName
tag explicitly, it will override any alternateClassName:
properties auto-detected from source code. This means you can't just use one @alternateClassName
to document one additional alternate name to those detected from source, instead you have to document all your alternate names with @alternateClassName
tags.
If you want to avoid the auto-detection and have a class with no alternate class names at all, use the @ignore tag:
/** @ignore */
alternateClassName: ["Ext.Panel", "XPanel"]