jsdoc-vue.md 2.1 KB

1、安装cnpm和jsdoc

npm config set registry https://registry.npm.taobao.org/
npm install cnpm -g 
npm install jsdoc -g

2、初始化项目

cnpm i 
cd example 
cnpm i

image-20230301201724705

3、示例

<template>
  <div>
    {{ message }}
    <button @click="increment">+1</button>
    <button @click="decrement">-1</button>
    <button @click="showDialog(counter)">Show counter value in dialog</button>
  </div>
</template>

<script>
  import { mapState } from 'vuex';

  /**
   * @module components/Counter
   * @desc <h5>计算</h5> Author:作者 <br>Date:2022-03-20 <br>Version:1.0.0<br>版本说明
   * @vue-prop {Number} [val=1] val - 描述
   * @vue-prop {Number} initialCounter 
   * @vue-data {Number} [counter=1] counter - 计数
   * @vue-computed {Array.<String>} fooList - A list of foo
   * @vue-computed {Array.<String>} barList - A list of bar
   * @vue-computed {String} message A message
   */
  export default {
    props: {
      initialCounter: {type: Number, required: true},
      step: {type: Number, default: 1}
    },
    data() {
      return {
        counter: this.initialCounter
      }
    },
    computed: {
      ...mapState({
        fooList: state => state.$_foo.fooList,
        barList: state => state.$_foo.barList
      }),
      message() {
        return `Counter: ${this.counter}`
      }
    },
    methods: {
      /**
       * 方法描述 :Show a dialog displaying counter value.
       * 
       * @param {Number} counter - Counter value
       * @return {Number} 描述
       */
      showDialog(counter) {
        alert(`Counter value is ${counter}.`);
      }
    },
  };
</script>

4、执行脚本生成文档

npm run docs:tui  或者使用命令
jsdoc -c .jsdoc-tui.js -r

5、注意事项路径不要重复,要不然会重复文档两次

image-20220907001800972

image-20220907001816309

  • SCR/ 已经包含了SRC/BETTER-COMPONENTS

image-20220907001856346

  • 正确写法