自主搭建vue2 + typescript + eslint, 及起飞姿式. 附脚手架源码typescript-vue-eslint-starter

目录

  • 脚手架搭建(typescript-vue-eslint-starter)
  • d.ts文件声明
  • vue-property-decorator 装饰器使用
  • vuex-class 装饰器使用
  • typescript按需转换ES6 Api

webpack 完整配置能够参考 typescript-vue-eslint-starter [ github.com/vok123/type… ]javascript

欢迎提建议,若是以为有用的给个star哈~vue

↓↓↓↓↓↓高能时刻↓↓↓↓↓↓java

开局一只蔡徐坤, 涨薪全靠vue + ts [www.bilibili.com/video/av503…]node

脚手架搭建

1. 安装依赖

  • 开发依赖
npm i -D @vue/cli-plugin-eslint @vue/eslint-config-standard @vue/eslint-config-typescript eslint eslint-loader eslint-plugin-node eslint-plugin-vue typescript ts-loader
复制代码
  • 项目依赖
npm i -S vue-class-component vue-property-decorator vuex-class
复制代码

2. Webpack loader配置 (ts-loader/eslint-loader)

完整webpack配置 [github.com/vok123/type…]webpack

module: {
  rules: [
    {
      test: /\.ts(x)?$/,
      loader: 'ts-loader',
      exclude: /node_modules/,
      options: {
        appendTsSuffixTo: [/\.vue$/],
        transpileOnly: true,
        happyPackMode: false
      }
    },
    {
      test: /\.(js|vue|ts|tsx|jsx)$/,
      enforce: 'pre',
      exclude: /node_modules/,
      loader: 'eslint-loader',
      options: {
        fix: false,
        extensions: ['.js', '.jsx', '.vue', '.ts', '.tsx'],
        cache: false,
        emitWarning: true,
        emitError: false
      }
    }
  ];
}
复制代码

3. 根目录添加eslint配置文件 .eslintrc.js

module.exports = {
  plugins: ['vue', '@typescript-eslint'],
  parserOptions: {
    parser: '@typescript-eslint/parser',
    ecmaVersion: 2017,
    sourceType: 'module'
  },
  root: true,
  env: {
    node: true
  },
  extends: [
    'plugin:vue/base',
    'plugin:@typescript-eslint/recommended',
    'plugin:vue/essential',
    '@vue/standard',
    '@vue/typescript'
  ],
  rules: {
    // eslint rules
    'one-var': 0,
    'arrow-parens': 0,
    'generator-star-spacing': 0,
    'no-debugger': 0,
    'no-console': 0,
    semi: [2, 'always'],
    'no-extra-semi': 2,
    'space-before-function-paren': 0,
    eqeqeq: 0,
    'spaced-comment': 0,
    'no-useless-escape': 0,
    'no-tabs': 0,
    'no-mixed-spaces-and-tabs': 0,
    'new-cap': 0,
    camelcase: 0,
    'no-new': 0,
    indent: 'off',
    // typescript-eslint rules
    '@typescript-eslint/indent': ['error', 2],
    '@typescript-eslint/explicit-function-return-type': 0
  }
};
复制代码

4. 根目录添加 tsconfig.json

{
  "compilerOptions": {
    "target": "es5",
    "module": "esnext",
    "strict": true,
    "jsx": "preserve",
    "importHelpers": true,
    "moduleResolution": "node",
    "experimentalDecorators": true,
    "esModuleInterop": true,
    "allowSyntheticDefaultImports": true,
    "sourceMap": true,
    "allowJs": true,
    "baseUrl": ".",
    "types": ["webpack-env", "node"],
    "paths": {
      "@/*": ["src/*"]
    },
    "lib": ["esnext", "dom", "dom.iterable", "scripthost"]
  },
  "include": [
    "src/**/*.ts",
    "src/**/*.tsx",
    "src/**/*.vue",
    "tests/**/*.ts",
    "tests/**/*.tsx"
  ],
  "exclude": ["node_modules"]
}
复制代码

d.ts文件声明

src/@types/shims-vue.d.ts

  • 声明.vue文件
declare module '*.vue' {
  import Vue from 'vue'
  export default Vue
}
复制代码
declare module "vue/types/vue" {
  interface Vue {
    $message: (msg: string): void;
    $balala: string;
  }
}
// 在组件中使用
this.$balala
this.$message('Hello world');
复制代码
declare module "vue/types/options" {
  interface ComponentOptions<V extends Vue> {
    i18n: any
  }
}
// 使用
new Vue({
  i18n, ...
});
复制代码
  • 声明第三方npm包
// 声明 element-ui
declare module 'element-ui'
// 声明 axios
declare module 'axios' {
  import Axios from 'axios/index';
  export default Axios;
}
复制代码

vue-property-decorator 装饰器使用

  • 经常使用装饰器及方法
装饰器 用途 描述
Component 声明class组件 只要是个组件都必须加该装饰器
Prop 声明props 对应普通组件声明中的props属性
Watch 声明监听器 对应普通组件声明中的watch属性
Mixins 混入继承 对应普通组件声明中的mixins属性
Emit 子组件向父组件值传递 对应普通this.$emit()
Inject 接收祖先组件传递的值 对应普通组件声明中的inject属性
Provide 祖先组件向其全部子孙后代注入一个依赖 对应普通组件声明中的provide属性
  • 用法ios

    • vue 钩子写法
    // javascript
    <script>
    export default {
      beforeCreate() {},
      created() {},
      beforeMount() {},
      mounted() {},
      beforeUpdate() {},
      updated() {},
      activated() {},
      deactivated() {},
      beforeDestroy() {},
      destroyed() {},
      errorCaptured() {}
    }
    </script>
    
    
    // --------typescript--------
    
    <script lang="ts">
    import { Component, Vue } from 'vue-property-decorator';
    
    @Component
    export default class App extends Vue {
      beforeCreate() {}
      created() {}
      beforeMount() {}
      mounted() {}
      beforeUpdate() {}
      updated() {}
      activated() {}
      deactivated() {}
      beforeDestroy() {}
      destroyed() {}
      errorCaptured() {}
    }
    </script>
    复制代码
    • Component
    // javascript
    import helloWorld from './helloWorld.vue';
    export default {
      components: {
        helloWorld
      }
    }
    
    // --------typescript--------
    import helloWorld from './helloWorld.vue';
    import { Component, Vue } from 'vue-property-decorator';
    
    @Component({
      components: {
        helloWorld
      }
    })
    export default class App extends Vue {}
    复制代码
    • Prop
    // javascript
    export default {
      props: {
        msg: {
          type: String,
          default: 'Hello world',
          required: true,
          validator: (val) => (val.length > 2)
        }
      }
    }
    
    // --------typescript--------
    import { Component, Vue, Prop } from 'vue-property-decorator';
    
    @Component
    export default class HelloWorld extends Vue {
      @Prop({
        type: String,
        default: 'Hello world',
        required: true,
        validator: (val) => (val.length > 2)
      }) msg!: string
    }
    复制代码
    • Watch
    // javascript
    export default {
      data() {
        return {
          value: ''
        }  
      },
      watch: {
        value: {
          handler() {
            console.log(this.value);
          },
          deep: true,
          immediate: true
        }
      }
    }
    
    // --------typescript--------
    import { Component, Vue, Watch } from 'vue-property-decorator';
    
    @Component
    export default class App extends Vue {
      value: string = ''
      @Watch('value', { deep: true, immediate: true })
      valueWatch() {
        console.log(this.value);
      }
    }
    复制代码
    • Mixins
    // javascript
    // -info.js
    export default {
      methods: {
        mixinsShow() {
          console.log('徐蔡坤');
        }
      }
    }
    // -hello-world.vue
    import mixinsInfo from './info.js';
    export default {
      mixins: [mixinsInfo]
      mounted() {
        this.mixinsShow(); // 徐蔡坤
      }
    }
    
    // --------typescript--------
    // -info.ts
     import { Component, Vue } from 'vue-property-decorator';
     @Component
     export default class MixinsInfo extends Vue {
        mixinsShow() {
          console.log('徐蔡坤');
        }
     }
    // -hello-world.vue
    import { Component, Vue, Mixins } from 'vue-property-decorator';
    import mixinsInfo from './info.ts';
    @Component
    export default class HelloWorld extends Mixins(mixinsInfo) {
      mounted() {
        this.mixinsShow(); // 徐蔡坤
      }
    }
    复制代码
    • Emit
    // javascript
    // -children.vue
    <template>
      <button @click="$emit('submit', '唱, 跳')">提交</button>
    </template>
    
    // -parent.vue
    <template>
      <children @submit="submitHandle"/>
    </template>
    import children from './children.vue';
    export default {
      components: {
        children
      },
      methods: {
        submitHandle(msg) {
          console.log(msg); // 唱, 跳
        }
      }
    }
    
    // --------typescript--------
    // -children.vue
    <template>
      <button @click="submit">提交</button>
    </template>
    
    <script lang="ts">
    import { Component, Vue, Emit } from 'vue-property-decorator';
    @Component
    export default class Children extends Vue {
      @Emit()
      submit() {
        return '唱, 跳';
      }
    }
    </script>
    
    // -parent.vue
    <template>
      <children @submit="submitHandle"/>
    </template>
    
    <script lang="ts">
    import children from './children.vue';
    import { Component, Vue } from 'vue-property-decorator';
    @Component({
      components: {
        children
      }
    })
    export default class Parent extends Vue {
      submitHandle(msg: string) {
        console.log(msg); // 唱, 跳
      }
    }
    </script>
    复制代码
    • Provide/Inject
    // javascript
    // -children.vue
    export default {
      inject: ['root'],
      mounted() {
        console.log(this.root.name); // rap, 篮球
      }
    }
    
    // -parent.vue
     <template>
      <children />
    </template>
    import children from './children.vue';
    export default {
      components: {
        children
      },
      data() {
        return {
          name: 'rap, 篮球'
        };
      },
      provide() {
        return {
          root: this
        };
      }
    }
    
    // --------typescript--------
    // -children.vue
    <script lang="ts">
    import { Component, Vue, Inject } from 'vue-property-decorator';
    @Component
    export default class Children extends Vue {
      @Inject() root!: any
      mounted() {
        console.log(this.root.name); // rap, 篮球
      }
    }
    </script>
    
    // -parent.vue
    <template>
      <children />
    </template>
    
    <script lang="ts">
    import children from './children.vue';
    import { Component, Vue, Provide } from 'vue-property-decorator';
    @Component({
      components: {
        children
      }
    })
    export default class Parent extends Vue {
      name: string = 'rap, 篮球'
      @Provide()
      root = this.getParent();
      getParent() {
        return this;
      }
    }
    </script>
    复制代码
    • 计算属性
    // javascript
    export default {
      data() {
        return {
          hobby: '唱, 跳, rap, 篮球'
        };
      },
      computed: {
        msg() {
          return '我也会' + this.hobby;
        }
      },
      mounted() {
        console.log(this.msg); // 我也会唱, 跳, rap, 篮球
      }
    }
    
    // --------typescript--------
    // -hello-world.vue
    import { Component, Vue } from 'vue-property-decorator';
    @Component
    export default class HelloWorld extends Vue {
      hobby: string = '唱, 跳, rap, 篮球'
      get msg() {
        return '我也会' + this.hobby;
      }
      mounted() {
        console.log(this.msg); // 我也会唱, 跳, rap, 篮球 
      }
    }
    复制代码

vuex-class 装饰器使用

装饰器 用途
State 获取vuex state
Getter 获取vuex getter
Mutation 获取vuex mutation
Action 获取vuex actions
  • vuex typescript 基础定义git

    // -store/store.ts
    
    import Vue from 'vue';
    import Vuex, { StoreOptions } from 'vuex';
    import user from './modules/user';
    
    Vue.use(Vuex);
    interface RootState {
      version: string;
    }
    const store: StoreOptions<RootState> = {
      strict: true,
      state: {
        version: '1.0.0'
      },
      modules: {
        user
      }
    };
    export default new Vuex.Store<RootState>(store);
    
    
    // -store/modules/user.ts
    import { Module } from 'vuex';
    export interface UserInfo {
      uId: string;
      name: string;
      age: number;
    }
    interface UserState {
      userInfo: UserInfo;
    }
    const user: Module<UserState, any> = {
      namespaced: true,
      state: {
        userInfo: {
          uId: '',
          name: '',
          age: 0
        }
      },
      getters: {
        isLogin(state) {
          return !!state.userInfo.uId;
        }
      },
      mutations: {
        updateUserInfo(state, userInfo: UserInfo): void {
          Object.assign(state.userInfo, userInfo);
        }
      },
      actions: {
        async getUserInfo({ commit }): Promise<void> {
          let { userInfo } = await getUserInfo();
          commit('updateUserInfo', userInfo);
        }
      }
    };
    export default user;
    
    复制代码
    • vuex-class 装饰器
    <script lang="ts">
    import { Component, Vue } from 'vue-property-decorator';
    import { State, Getter, Action } from 'vuex-class';
    import { UserInfo } from './store/modules/user';
    @Component
    export default class App extends Vue {
      @State('version') version!: string
      @State('userInfo', { namespace: 'user' }) userInfo!: UserInfo
      @Getter('isLogin', { namespace: 'user' }) isLogin!: boolean
      @Action('getUserInfo', { namespace: 'user' }) getUserInfo!: Function
      mounted() {
        this.getUserInfo();
        console.log(this.version); // 1.0.0
      }
    }
    </script>
    复制代码
    • 在非vue组件的.ts中获取store数据
    // test.ts
    import store from './store/store';
    
    if (store.getters['user/isLogin'] === false) {
      console.log('未登陆');
    }
    复制代码

typescript按需转换ES6 Api

默认状况下typescript在转换语法为es3或者es5时并不会转换ES6 Api, 例如(Object.values, Array.fill ...) 在这种状况下咱们能够使用 (ts-polyfill) [github.com/ryanelian/t…] 定向指定须要转换的apigithub

相关文章
相关标签/搜索