@titanmatrix/vue3-class-component v0.2.17

vue3 class component

使用类来书写vue3组件,实践OOP

使用前提条件

需要安装 reflect-metadata 这个库，并且在项目入口需要引入:

npm add reflect-metadata

import 'reflect-metadata'

tsconfig.json 需要增加配置:

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "useDefineForClassFields": false
  } 
}

安装

npm add @titanmatrix/vue3-class-component --save

API

2个基础类

1. 组件继承 VueComponent
2. 服务继承 VueService

组件编写

import {
  ComponentProps,
  Computed,
  Hook,
  Ref,
  VueComponent
} from '@titanmatrix/vue3-class-component'
import { ChildService } from './child.service'

/**
 * 组件属性
 */
interface ChildProps {
  /**
   * 尺寸
   */
  size: number
  /**
   * 姓名
   */
  name?: string
}

export class Child extends VueComponent<ChildProps> {
  /**
   * vue描述的属性定义
   */
  static defaultProps: ComponentProps<ChildProps> = {
    size: {
      type: Number,
      required: true,
    },
    name: String,
  }
  childService = new ChildService()
  @Ref() name = 'child'

  @Computed()
  get nameUpper() {
    return this.name.toUpperCase()
  }

  @Hook('Mounted')
  mounted() {
    console.log('mounted')
  }
  
  @Link()
  root?: HTMLDivElement

  constructor() {
    super()
    //  watch 需要写在 constructor中
    watch(() => this.name, this.nameChange)
  }

  nameChange = () => {
    console.log(this.name)
  }

  render() {
    return (
      <div ref={'root'}>
        属性：{this.props.size}
        <h2>自有变量</h2>i am a {this.name}
        大写 {this.nameUpper}
        reactive 变量 {this.obj.age}
        <h3>service</h3>
        <button onClick={() => this.childService.add()}>+</button>
        {this.childService.count}
        <button onClick={() => this.childService.reduce()}>-</button>
      </div>
    )
  }
}

服务

通常服务是指很纯粹的业务逻辑，等价于vue3新提出的 useFunction, 例子如下：

import { Hook, Ref, VueService, WatchEffect } from '@titanmatrix/vue3-class-component'
import { InjectionKey } from 'vue'

/**
 * 服务需要继承 VueService
 */
export class ChildService extends VueService {
  // 如果有此属性将自动 provide
  static ProviderKey: InjectionKey<ChildService> = Symbol()
  /**
   * 正常变量定义，成为响应式变量
   */
  @Ref() count = 1

  countChange() {
    console.log(this.count)
  }
  @Hook('BeforeUnmount')
  destroy() {
    console.log('做一些清理工作')
  }

  add() {
    this.count++
  }
  reduce() {
    this.count--
  }
}