javascript - VS2010 : javascript intellisense : specifying properties for 'options' objects passed to methods

Question

由于 javascript intellisense 实际上似乎在 VS2010 中工作，我想我可能会添加一些到我包含在几乎所有内容中的那些脚本中。

问题是，在一些复杂的函数上，我使用选项对象而不是传递无数不同的参数，如下所示:

function myFunc(options){
    var myVar1 = options.myVar1,
        myVar2 = options.myVar2,
        myVar3 = options.myVar3;
    ...
}

我遇到的问题是，似乎没有办法指定哪些属性 options需要有。我试过这个:

function myFunc(options){
    ///<summary>my func does stuff...</summary>
    ///<param name="options">
    ///myVar1 : the first var
    ///myVar2 : the second var
    ///myVar3 : the third var
    ///</param>

    var myVar1 = options.myVar1,
        myVar2 = options.myVar2,
        myVar3 = options.myVar3;
    ...
}

但是换行符被删除了，所有的属性注释都放在一起，使它们难以阅读。

我试过 <para>标签，但无济于事。

如果有人对我如何实现这一目标有任何想法，请告诉我。

-布兰登

Answer 1

您可以使用以下语法强制换行:

/// <summary>
///   My method description  
/// </summary>
/// <param name="options" type="Object">
///     A JSON Object
///     &#10;1 - prop1: name
///     &#10;2 - prop2: id
///     &#10;3 - onSuccess: function to exec
/// </param>