Использование тега @typedef Google Closure

Компилятор Google Closure имеет тег "@typedef", но он можно использовать их в своем коде? (Я знаю, что это сработает, но не одобряют ли это?)

Итак, вот мой тип

/**
 * The plan object's typedef
 * @typedef {Object}
 */
Types.Plan = {
    "style": "bordersmall",
    "width": "50%",
    "height": "40%",
    "x": "20%",
    "y": "10%",
    "clickable": true,
    "moveable": true
};

И затем я могу использовать этот тип в своих аннотациях JSDoc.

Это позволяет моей среде IDE давать мне автозаполнение в переданный параметр

Итак, объявленный объект не ' t используется где-нибудь в коде.

/**
 * The Instructions class
 * @param   {Types.Plan}    plan        Plan for position and dimension
 * @param   {Manager}       manager     The manager
 * @param   {Instructions}  parent      This widget's parent's instructions
 * @return  {Instructions}              Returns the new instructions object
 */
Instructions = function(plan, manager, parent){
    plan.
}

Так это нормально? Или есть лучшее решение?

7
задан skerit 10 May 2011 в 11:44
поделиться