2

我想创建足够的文档并为返回 Deferred 对象的函数启用提示。用 JSDoc 记录 Deferred.done 回调的正确方法是什么（如果有的话）？到目前为止，我有：

/**
 * Creates component element.
 * @param {Object} settings
 * @returns {Deferred}
 */
$.fn.customDialogue.createElement = function (settings) {
    var deferred = $.fn.dialogue.createElement(settings);
    $.when(…).done(function (dialogueElement) {
        deferred.resolve(dialogueElement.customDialogue(settings));
    });
    return deferred;
};

我想在文档中指出返回的延迟done()回调接受@param {jQuery} element，例如：

$deferred.done(function(element){
    …
});

编辑：

我正在使用 PhpStorm，它不完全支持 JSDoc，但以下似乎可行。如果您知道，请发布更好的解决方案。

/**                                                                                              
 * @function                                                                                     
 * @name Deferred.done                                                                           
 * @param {function(element:jQuery)} callback                                                    
 */                                                                                              

/**                                                                                              
 * Creates new component element and returns a deferred object.                                  
 * @param {Object} settings                                                                      
 * @returns {Deferred}                                                                           
 */                                                                                              
$.fn.customDialogue.createElement = function (settings) {
    var deferred = $.fn.dialogue.createElement(settings);
    $.when(…).done(function (dialogueElement) {
        deferred.resolve(dialogueElement.customDialogue(settings));
    });
    return deferred;
};

看起来像这样：http ://d.pr/i/j506

4

0 回答 0