代码之家 › 专栏 › 技术社区 › Master Morality

VS2010:javascript intellisense:指定传递给方法的“options”对象的属性

vsdoc intellisense visual-studio-2010 javascript

Master Morality · 技术社区 · 16 年前

因为javascript intellisense实际上似乎在VS2010中工作,所以我想我可以在几乎所有的脚本中添加一些。

问题是,在一些复杂的函数中,我使用option对象,而不是传递许多不同的参数,例如:

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> 标签,但没用。

如果有人对我如何做到这一点有任何想法,请告诉我。

-布兰登

3 回复 | 直到 16 年前

Christopher 15 年前

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

/// <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>

anthony sottile 15 年前

使用Microsoft的JScript编辑器扩展: http://visualstudiogallery.msdn.microsoft.com/872d27ee-38c7-4a97-98dc-0d8a431cc2ed

<para> 现在支持标记

InfinitiesLoop 16 年前

jQuery的vsdoc文件使用这种方法。你只需要尝试格式化它,这样即使它都在一行上,它也能读一些。例如,以下是jQuery 1.4.1vsdoc文件的摘录:

jQuery.fn[ "blur" ] = function( fn ) {
/// <summary>
///     1: blur() - Triggers the blur event of each matched element.
///     2: blur(fn) - Binds a function to the blur event of each matched element.
/// </summary>
/// <param name="fn" type="Function">The function to execute.</param>
/// <returns type="jQuery" />

return fn ? this.bind( "blur", fn ) : this.trigger( "blur" );

生成的工具提示确实将其全部放在一行上,但由于每个项的结构(特别是因为每个项的末尾都有一个“.”),它仍然相当可读。

推荐文章

code-geek · Jquery根据单选按钮选择隐藏或显示文本字段

1 年前

Niobos · 如何/是否有方法使通用算法函数同时与同步和异步函数一起工作?

1 年前

Alex · 在轻量级中同时解构和不解构变量

1 年前

Ângelo Rigo · ReactJS映射:如何迭代[关闭]

1 年前

bairog · 从按属性筛选的对象数组字典中创建值数组

1 年前

KaiMcKiernan · 基于Math.random()的函数在另一个函数内不起作用[关闭]

1 年前

David Jeong · 浏览器不会为浏览器自动添加的某些标头发送CORS预检请求吗?

1 年前

user29519291 · 为不同的变量创建一个带有可重用Click函数的简单菜单

1 年前

user3472810 · Angular@Output/EventEmitter返回undefined

1 年前

lokiuucx · JS对象属性返回未定义,尽管对象属性应该有值

1 年前