我个人不是生成文档的忠实拥护者(我更像是一个“阅读源代码Luke”的人),但我可以看到此类文档对其他人有何用处。现在,通常他们生成的文档不会影响我,除了一件事:@method。大多数JSDoc注释(例如@param)对于阅读源代码的人来说仍然非常有用,但是@method是100%冗余的:/**@paramnumnumbertoaddfiveto*@methodaddFive*/functionaddFive(num){...所以,我真的很想避免让数百行@method弄乱我们的代码。但是,我的同事认为@method是JSDoc生成器(他使用的是YUI生成器)能够生成类的方法列表所必需的。
在JSDoc可以记录数组内容的确切类型likethis:/**@param{Array.}myClassesAnarrayofMyClassobjects.*/TestClass.protoype.someMethod=function(myClasses){myClasses[0].aMethodOnMyClass();}这使得像WebStorm这样的IDE中的代码完成实际上在[0].之后提供了正确的类型信息。这适用于数组类型,但我有自己的集合类型,我也想在其中使用此功能。问题是我找不到正确的语法(可能是因为还没有)。我希望能够像这样以某种方式声明我的类(class):/***@ty
JSDoc有什么文件吗?两个IntelliJ支持的子集、超集或混合?我使用JSDoc的动机有两个:对于开发人员:IntelliJ可以提供更好的代码完成、代码检查、错误检查等。为了提高运行效率:使用Closurecompiler.对于上面的第1点,使用IntelliJ支持的JSDoc标记对我来说很重要,直到现在解决这个问题主要是一个反复试验的过程。 最佳答案 基于WebStormdocumentation中可用的少量信息,看起来IntelliJIDEA支持整个JSDoc集。文档中唯一的其他说明在viewinginlinedocumen
我一直在尝试使用JSDoc记录以下代码:/***@moduleperson*//***Ahumanbeing.*@class*@param{string}name*/functionPerson(name){this.name=name}Person.prototype=newfunction(){varamount_of_limbs=4;/***Introduceyourself*/this.greet=function(){alert("Hello,mynameis"+this.name+"andIhave"+amount_of_limbs+"limbs");}}但是在生成的JSD
我知道周围有各种风格的JSDoc。而且似乎每个JSDoc解析器的实现都可以识别它自己的一组标记。例如,考虑http://usejsdoc.org/之间的标签差异。和http://www.techrepublic.com/blog/programming-and-development/create-useful-relevant-javascript-documentation-with-jsdoc/451.在这一点上,我只是感到困惑。是否有JSDoc的规范实现或一组广泛认可的核心标签?是否有JSDoc的最佳实现?编辑正如下面的评论中所问,这个问题的原因是我需要解析JSDoc评论以便与
我想创建一个数据库支持的交互式AJAXwebapp,它有一个自定义(特定类型的事件,编辑)日历系统。这将涉及大量的JavaScript和AJAX,我想到了用于界面的GoogleWebToolkit和用于服务器端的RubyonRails。GoogleWebToolkit可靠且优秀吗?如果选择GoogleWebToolkit,会有哪些隐患?可以在服务器端轻松地将它与RubyonRails结合起来吗?或者我应该尝试直接使用像jQuery这样的JavaScript库吗?除了一些HTML之外,我没有Web开发经验,但我是一名经验丰富的程序员(c++、java、c#),我想在此项目中只使用免费工具
有人用JSDoc记录过BackboneJS代码吗?我在注释Backbone构造时遇到问题,例如:User=Backbone.Model.extend({defaults:{a:1},initialize:function(){//...},doSomething:function(p){//...}});任何建议表示赞赏。谢谢。 最佳答案 如果您谈论的是JSDoc工具包,我认为它以某种方式工作:User=Backbone.Model.extend(/**@lendsUser.prototype*/{/***@classUsercla
菜单类文档-以及提供的示例-似乎没有显示任何方法让我构建具有超过1级导航的导航菜单。如果我想构建一个“应用程序风格”的菜单(例如"file"或“编辑”),其中将包含子菜单,我该怎么办?有没有一种方法可以使用AgileToolkit自动创建它,或者这是必须使用html模板、css文件等手动编码的东西? 最佳答案 默认情况下没有这样的组件-但是,“即插即用”View也适用于菜单的这是现实生活中二级子菜单的一个例子:http://www.gradpool.ie/gradmatcher/graduate/company.html?id=38
我正在尝试让GoogleIdentityToolkitAPI为基于PHP的应用程序工作。我一直在关注Google提供的快速入门指南:https://developers.google.com/identity/toolkit/web/quickstart/php我完全按照这些步骤操作(并检查并仔细检查)。登录按钮出现在index.php页面上。单击此重定向到widget.php页面。我可以选择要登录的帐户,然后当返回到成功登录页面(再次是index.php)时,我收到以下错误消息:Fatalerror:Uncaughtexception'Google_Auth_Exception'wi
我目前有一个主要的JavaWeb应用程序项目,其中包含一些Servlet、JSP和静态HTML页面。后来,我还创建了第二个EclipseGoogleWebToolkit项目(GWT)。现在,在完成GWT项目后,我想将GWT项目(同时保留其带有Servlet的RPC功能)与PrimaryJavaWebApp项目集成或合并。我需要在哪个目录中将文件和文件夹从GWT项目复制粘贴到JavaWebApp项目?请记住,我想导出完全编译的JavaScript代码而不是Java字节代码。 最佳答案 您可以将GWT项目中的所有Java文件准确地放在它