詳解vue-property-decorator使用手冊

一，安裝

npm i -s vue-property-decorator

創(chuàng)新互聯(lián)建站是一家網(wǎng)站設(shè)計(jì)公司，集創(chuàng)意、互聯(lián)網(wǎng)應(yīng)用、軟件技術(shù)為一體的創(chuàng)意網(wǎng)站建設(shè)服務(wù)商，主營產(chǎn)品：響應(yīng)式網(wǎng)站、高端網(wǎng)站設(shè)計(jì)、成都營銷網(wǎng)站建設(shè)。我們專注企業(yè)品牌在網(wǎng)站中的整體樹立，網(wǎng)絡(luò)互動(dòng)的體驗(yàn)，以及在手機(jī)等移動(dòng)端的優(yōu)質(zhì)呈現(xiàn)。網(wǎng)站建設(shè)、網(wǎng)站設(shè)計(jì)、移動(dòng)互聯(lián)產(chǎn)品、網(wǎng)絡(luò)運(yùn)營、VI設(shè)計(jì)、云產(chǎn)品.運(yùn)維為核心業(yè)務(wù)。為用戶提供一站式解決方案，我們深知市場的競爭激烈，認(rèn)真對(duì)待每位客戶，為客戶提供賞析悅目的作品，網(wǎng)站的價(jià)值服務(wù)。

二，用法

1，@Component(options:ComponentOptions = {})

@Component 裝飾器可以接收一個(gè)對(duì)象作為參數(shù)，可以在對(duì)象中聲明 components ，filters，directives 等未提供裝飾器的選項(xiàng)

雖然也可以在 @Component 裝飾器中聲明 computed，watch 等，但并不推薦這么做，因?yàn)樵谠L問 this 時(shí)，編譯器會(huì)給出錯(cuò)誤提示

import { Vue, Component } from 'vue-property-decorator'

@Component({
 filters: {
 toFixed: (num: number, fix: number = 2) => {
 return num.toFixed(fix)
 }
 }
})
export default class MyComponent extends Vue {
 public list: number[] = [0, 1, 2, 3, 4]
 get evenList() {
 return this.list.filter((item: number) => item % 2 === 0)
 }
}

2，@Prop(options: (PropOptions | Constructor[] | Constructor) = {})

@Prop 裝飾器接收一個(gè)參數(shù)，這個(gè)參數(shù)可以有三種寫法：

  • Constructor ，例如 String，Number，Boolean 等，指定 prop 的類型；
  • Constructor[] ，指定 prop 的可選類型；
  • PropOptions ，可以使用以下選項(xiàng)： type，default，required，validator 。
import { Vue, Component, Prop } from 'vue-property-decorator'
@Componentexport default class MyComponent extends Vue {
 @Prop(String) propA: string | undefined
 @Prop([String, Number]) propB!: string | number
 @Prop({
 type: String,
 default: 'abc'
 })
 propC!: string
}

等同于下面的 js 寫法

export default {
 props: {
 propA: {
 type: Number
 },
 propB: {
 default: 'default value'
 },
 propC: {
 type: [String, Boolean]
 }
 }
}

注意：

  • 屬性的ts類型后面需要加上 undefined 類型；或者在屬性名后面加上!，表示 非null 和 非undefined
  • 的斷言，否則編譯器會(huì)給出錯(cuò)誤提示；
  • 指定默認(rèn)值必須使用上面例子中的寫法，如果直接在屬性名后面賦值，會(huì)重寫這個(gè)屬性，并且會(huì)報(bào)錯(cuò)。

3，@PropSync(propName: string, options: (PropOptions | Constructor[] | Constructor) = {})

  • @PropSync 裝飾器與 @prop 用法類似，二者的區(qū)別在于：
  • @PropSync 裝飾器接收兩個(gè)參數(shù)： 

propName: string 表示父組件傳遞過來的屬性名； 

options: Constructor | Constructor[] | PropOptions 與 @Prop 的第一個(gè)參數(shù)一致；

@PropSync 會(huì)生成一個(gè)新的計(jì)算屬性。

import { Vue, Component, PropSync } from 'vue-property-decorator'
@Component
export default class MyComponent extends Vue {
 @PropSync('propA', { type: String, default: 'abc' }) syncedPropA!: string
}

等同于下面的 js 寫法

export default {
 props: {
 propA: {
 type: String,
 default: 'abc'
 }
 },
 computed: {
 syncedPropA: {
 get() {
 return this.propA
 },
 set(value) {
 this.$emit('update:propA', value)
 }
 }
 }
}

注意： @PropSync 需要配合父組件的 .sync 修飾符使用

4，@Model(event?: string, options: (PropOptions | Constructor[] | Constructor) = {})

@Model 裝飾器允許我們在一個(gè)組件上自定義 v-model ，接收兩個(gè)參數(shù)：

event: string 事件名。

options: Constructor | Constructor[] | PropOptions 與 @Prop 的第一個(gè)參數(shù)一致。

import { Vue, Component, Model } from 'vue-property-decorator'
@Component
export default class MyInput extends Vue {
 @Model('change', { type: String, default: '123' }) value!: string
}

等同于下面的 js 寫法

export default {
 model: {
 prop: 'value',
 event: 'change'
 },
 props: {
 value: {
 type: String,
 default: '123'
 }
 }
}

上面例子中指定的是 change 事件，所以我們還需要在 template 中加上相應(yīng)的事件：

<template>
 <input
 type="text"
 :value="value"
 @change="$emit('change', $event.target.value)"
 />
</template>

對(duì) 自定義v-model 不太理解的同學(xué)，可以查看 自定義事件

5，@Watch(path: string, options: WatchOptions = {})

@Watch 裝飾器接收兩個(gè)參數(shù)：

path: string 被偵聽的屬性名；
options?: WatchOptions={} options 可以包含兩個(gè)屬性 ：

immediate?:boolean 偵聽開始之后是否立即調(diào)用該回調(diào)函數(shù)；

deep?:boolean 被偵聽的對(duì)象的屬性被改變時(shí)，是否調(diào)用該回調(diào)函數(shù)；

偵聽開始，發(fā)生在 beforeCreate 勾子之后， created 勾子之前

import { Vue, Component, Watch } from 'vue-property-decorator'

@Component
export default class MyInput extends Vue {
 @Watch('msg')
 onMsgChanged(newValue: string, oldValue: string) {}

 @Watch('arr', { immediate: true, deep: true })
 onArrChanged1(newValue: number[], oldValue: number[]) {}

 @Watch('arr')
 onArrChanged2(newValue: number[], oldValue: number[]) {}
}

等同于下面的 js 寫法

export default {
 watch: {
 msg: [
 {
 handler: 'onMsgChanged',
 immediate: false,
 deep: false
 }
 ],
 arr: [
 {
 handler: 'onArrChanged1',
 immediate: true,
 deep: true
 },
 {
 handler: 'onArrChanged2',
 immediate: false,
 deep: false
 }
 ]
 },
 methods: {
 onMsgVhanged(newValue, oldValue) {},
 onArrChange1(newValue, oldValue) {},
 onArrChange2(newValue, oldValue) {}
 }
}

6，@Emit(event?: string)

  • @Emit 裝飾器接收一個(gè)可選參數(shù)，該參數(shù)是 $Emit 的第一個(gè)參數(shù)，充當(dāng)事件名。如果沒有提供這個(gè)參數(shù)， $Emit 會(huì)將回調(diào)函數(shù)名的 camelCase 轉(zhuǎn)為 kebab-case ，并將其作為事件名；
  • @Emit 會(huì)將回調(diào)函數(shù)的返回值作為第二個(gè)參數(shù)，如果返回值是一個(gè) Promise 對(duì)象， $emit 會(huì)在 Promise 對(duì)象被標(biāo)記為 resolved 之后觸發(fā)；
  • @Emit 的回調(diào)函數(shù)的參數(shù)，會(huì)放在其返回值之后，一起被 $emit 當(dāng)做參數(shù)使用。
import { Vue, Component, Emit } from 'vue-property-decorator'

@Component
export default class MyComponent extends Vue {
 count = 0
 @Emit()
 addToCount(n: number) {
 this.count += n
 }
 @Emit('reset')
 resetCount() {
 this.count = 0
 }
 @Emit()
 returnValue() {
 return 10
 }
 @Emit()
 onInputChange(e) {
 return e.target.value
 }
 @Emit()
 promise() {
 return new Promise(resolve => {
 setTimeout(() => {
 resolve(20)
 }, 0)
 })
 }
}

等同于下面的 js 寫法

export default {
 data() {
 return {
 count: 0
 }
 },
 methods: {
 addToCount(n) {
 this.count += n
 this.$emit('add-to-count', n)
 },
 resetCount() {
 this.count = 0
 this.$emit('reset')
 },
 returnValue() {
 this.$emit('return-value', 10)
 },
 onInputChange(e) {
 this.$emit('on-input-change', e.target.value, e)
 },
 promise() {
 const promise = new Promise(resolve => {
 setTimeout(() => {
  resolve(20)
 }, 0)
 })
 promise.then(value => {
 this.$emit('promise', value)
 })
 }
 }
}

7，@Ref(refKey?: string)

@Ref 裝飾器接收一個(gè)可選參數(shù)，用來指向元素或子組件的引用信息。如果沒有提供這個(gè)參數(shù)，會(huì)使用裝飾器后面的屬性名充當(dāng)參數(shù)

import { Vue, Component, Ref } from 'vue-property-decorator'
import { Form } from 'element-ui'

@Componentexport default class MyComponent extends Vue {
 @Ref() readonly loginForm!: Form
 @Ref('changePasswordForm') readonly passwordForm!: Form

 public handleLogin() {
 this.loginForm.validate(valide => {
 if (valide) {
 // login...
 } else {
 // error tips
 }
 })
 }
}

等同于下面的 js 寫法

export default {
 computed: {
 loginForm: {
 cache: false,
 get() {
 return this.$refs.loginForm
 }
 },
 passwordForm: {
 cache: false,
 get() {
 return this.$refs.changePasswordForm
 }
 }
 }
}

@Provide/@Inject 和 @ProvideReactive/@InhectReactive

由于平時(shí)基本不用到provide/inject選項(xiàng)，暫時(shí)先放著，以后有時(shí)間再研究

參考： https://github.com/kaorun343/...

總結(jié)

以上所述是小編給大家介紹的vue-property-decorator使用手冊,希望對(duì)大家有所幫助，如果大家有任何疑問請(qǐng)給我留言，小編會(huì)及時(shí)回復(fù)大家的。在此也非常感謝大家對(duì)創(chuàng)新互聯(lián)網(wǎng)站的支持！
如果你覺得本文對(duì)你有幫助，歡迎轉(zhuǎn)載，煩請(qǐng)注明出處，謝謝！

網(wǎng)站欄目：詳解vue-property-decorator使用手冊
文章地址：http://bm7419.com/article36/iihppg.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站導(dǎo)航、面包屑導(dǎo)航、品牌網(wǎng)站設(shè)計(jì)、響應(yīng)式網(wǎng)站、網(wǎng)站內(nèi)鏈、營銷型網(wǎng)站建設(shè)

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請(qǐng)盡快告知，我們將會(huì)在第一時(shí)間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場，如需處理請(qǐng)聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時(shí)需注明來源： 創(chuàng)新互聯(lián)

手機(jī)網(wǎng)站建設(shè)