### HBuilder JSDoc+规范 目录 #### 介绍 JSDoc有2个作用，导出API文档和明确代码类型，辅助代码提示。 JSDoc描述了函数或变量的功能、值域、示例等很多代码提示时需要的数据，还可以通过类型定义，给动态的JS变量或函数赋予明确的类型。 HBuilder支持JSDoc3的书写和解析，JSDoc 3详细的标签介绍及语法请参考JSDoc 3。 但标准的JSDoc是不够的，为了提高JS代码类型解析的精确性和实现更强大的代码助手提示，我们扩展了JSDoc。 -对于普通开发者，书写JSDoc有助于代码可读性的提升，在很多要求严格的大公司，JSDoc是强制要求编写的。 完善的JSDoc也能让开发者自定义的函数在引用时得到更方便的代码提示。 -对于框架开发者，书写好的JSDoc是必须的，除了生成API手册，良好的JSDoc可以让框架在IDE里得到更好的提示。 -开发者们也可以给别人的JS框架补充JSDoc，以便在HBuilder里得到更好的提示。 如果你完成了某个框架的JSDoc，请提交到`https://github.com/dcloudio/WebFrameworkGrammar`，广大开发者都在期待你给大家带来的便利。 另外共享框架语法是可以获得HBuilder积分奖励的哦。 JSDoc写法 ~~~ /** 文档注释写在这里 ，生成JSDoc的快捷键是[Alt+shift+J]。 */。 ~~~ * * * * * http://www.html5plus.org/doc/jsdocp.html http://ask.dcloud.net.cn/article/129