Question

在javascript中使用以下内容非常常见：

function A (options, aaa, bbb) {
  var ccc = options.ccc;
  var ddd = options.ddd;
}

目前我正在评论它：

/**
 * a completely useless function
 *
 * @param {Object} options where options.ccc is {Number} ccc and options.ddd is {String} ddd
 * @param {Boolean} aaa
 * @param {String} bbb
 */

我对我在options参数

中描述属性的方式不满意

是否有一种干净的方式将它们置于“{Type} description”模式中？

Answer 1

我通常在变量名称后面放一个或两个TAB ......在描述之前。我同意了......我也不是一个巨大的粉丝。但是，这就是jsdocs处理它的方式。如果您过多地使用格式化，则可能无法解析出正确的文档。

/**
 * SLP.Modules.Codes extends the SLP.Modules object on DOM-ready.
 * @module Codes
 */
SLP.Modules.Codes = {
    /**
     * First validate for empty fields, then check the campaign codes,
     * making sure that they begin with T(oyota), L(exus), or S(cion).
     * @param  {object} event   jQuery Event object (form submit)
     * @return {boolean}        true if all validation passes.
     */
    validateCampaignCodes: function(event){
        var $input, isValid = SLP.validateFormInputsNotEmpty(event);
        if (isValid) {// Continue validation if all fields are non-empty.
            $input = $("input").filter("[name=campaign_code]").each(function(){
                if (!(isValid = /^[TLS]/i.test(this.value))) {
                    return !SLP.DOM.$modalPrompt.find(".modal-body").html( // Error msg.
                        "Campaign Codes must begin with T(oyota), S(cion), or L(exus)."
                    ).end().modal("show");// On error, immediately exit (the each method).
                }
            });
        }
        // Convert campaign codes to uppercase for submission.
        $input.val(function(i,v){ return v.toUpperCase(); });
        // Enable all checkboxes to submit values with form.
        $("input[type=checkbox]").attr("disabled", false);
        return isValid;
    },

评论嵌套参数

1 个答案: