javascript代码实例教程-JSDoc 3 生成javascript API文档

发布时间:2019-02-04 发布网站:脚本宝典
脚本宝典收集整理的这篇文章主要介绍了javascript代码实例教程-JSDoc 3 生成javascript API文档脚本宝典觉得挺不错的,现在分享给大家,也给大家做个参考。
小宝典致力于为广大程序猿(媛)提供高品质的代码服务,请大家多多光顾小站,小宝典在此谢过。 烟火_

JSDoc 3 生成javascript API文档

 

一、javascript注释规范

 

  我们在编写javascript文件的时候,一般会添加一些注释。例如一些文件、类、方法和属性都应该用合适的标记和类型进行注释。这里不但方便我们的阅读,也能养成一个好的习惯。更大的好处是,我们可以根据这些注释生成帮助文档。如下就是一个比较规范的javascript注释例子。

 

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

/**

 * MyClass

 * @class MyClass

 * @constructor

 */

function MyClass() {

 

    /**

     * a属性

     * @PRoPErty a 

     * @type int

     **/

    VAR a = 0;

 

    /**

    获得A的值

    @memberof MyClass

    @method getA 

    @param returnType {int} 要设置的值

    @example   ele.setReturnType('0000');

     **/

    function setA(a) {

        this.a = a;

    }

 

    /**

    设置A的值

    @memberof MyClass

    @method getA 

    @param returnType {int} 要设置的值

    @example   ele.setReturnType('0000');

     **/

    function getA() {

        return a;

    }

 

}

觉得可用,就经常来吧! 脚本宝典 欢迎评论哦! js脚本,巧夺天工,精雕玉琢。小宝典献丑了!

脚本宝典总结

以上是脚本宝典为你收集整理的javascript代码实例教程-JSDoc 3 生成javascript API文档全部内容,希望文章能够帮你解决javascript代码实例教程-JSDoc 3 生成javascript API文档所遇到的问题。

如果觉得脚本宝典网站内容还不错,欢迎将脚本宝典推荐好友。

本图文内容来源于网友网络收集整理提供,作为学习参考使用,版权属于原作者。
如您有任何意见或建议可联系处理。小编QQ:384754419,请注明来意。