做自(zì)由與創造的先行者

組件 v-model

Vue.js中文(wén)手冊

v-model 可以在組件上(shàng)使用(yòng)以實現(xiàn)雙向綁定。

首先讓我們回憶一下(xià) v-model 在原生元素上(shàng)的用(yòng)法:

template

<input v-model="searchText" />

在代碼背後,模闆編譯器會(huì)對(duì) v-model 進行更冗長的等價展開(kāi)。因此上(shàng)面的代碼其實等價于下(xià)面這(zhè)段:

template

<input

:value="searchText"

@input="searchText = $event.target.value"

/>

而當使用(yòng)在一個組件上(shàng)時(shí),v-model 會(huì)被展開(kāi)爲如下(xià)的形式:

template

<CustomInput

:modelValue="searchText"

@update:modelValue="newValue => searchText = newValue"

/>

要讓這(zhè)個例子實際工(gōng)作(zuò)起來(lái),<CustomInput> 組件内部需要做兩件事(shì):

将内部原生 <input> 元素的 value attribute 綁定到(dào) modelValue prop

當原生的 input 事(shì)件觸發時(shí),觸發一個攜帶了(le)新值的 update:modelValue 自(zì)定義事(shì)件

這(zhè)裏是相應的代碼:

vue

<!-- CustomInput.vue -->

<script>

export default {

props: ['modelValue'],

emits: ['update:modelValue']

}

</script>

<template>

<input

:value="modelValue"

@input="$emit('update:modelValue', $event.target.value)"

/>

</template>

現(xiàn)在 v-model 可以在這(zhè)個組件上(shàng)正常工(gōng)作(zuò)了(le):

template

<CustomInput v-model="searchText" />

另一種在組件内實現(xiàn) v-model 的方式是使用(yòng)一個可寫的,同時(shí)具有 getter 和(hé) setter 的 computed 屬性。get 方法需返回 modelValue prop,而 set 方法需觸發相應的事(shì)件:

vue

<!-- CustomInput.vue -->

<script>

export default {

props: ['modelValue'],

emits: ['update:modelValue'],

computed: {

value: {

get() {

return this.modelValue

},

set(value) {

this.$emit('update:modelValue', value)

}

}

}

}

</script>

<template>

<input v-model="value" />

</template>

v-model 的參數 ​

默認情況下(xià),v-model 在組件上(shàng)都是使用(yòng) modelValue 作(zuò)爲 prop,并以 update:modelValue 作(zuò)爲對(duì)應的事(shì)件。我們可以通過給 v-model 指定一個參數來(lái)更改這(zhè)些(xiē)名字:

template

<MyComponent v-model:title="bookTitle" />

在這(zhè)個例子中,子組件應聲明(míng)一個 title prop,并通過觸發 update:title 事(shì)件更新父組件值:

vue

<!-- MyComponent.vue -->

<script>

export default {

props: ['title'],

emits: ['update:title']

}

</script>

<template>

<input

type="text"

:value="title"

@input="$emit('update:title', $event.target.value)"

/>

</template>

多個 v-model 綁定 ​

利用(yòng)剛才在 v-model 參數小(xiǎo)節中學到(dào)的指定參數與事(shì)件名的技巧,我們可以在單個組件實例上(shàng)創建多個 v-model 雙向綁定。

組件上(shàng)的每一個 v-model 都會(huì)同步不同的 prop,而無需額外(wài)的選項:

template

<UserName

v-model:first-name="first"

v-model:last-name="last"

/>

vue

<script>

export default {

props: {

firstName: String,

lastName: String

},

emits: ['update:firstName', 'update:lastName']

}

</script>

<template>

<input

type="text"

:value="firstName"

@input="$emit('update:firstName', $event.target.value)"

/>

<input

type="text"

:value="lastName"

@input="$emit('update:lastName', $event.target.value)"

/>

</template>

處理(lǐ) v-model 修飾符 ​

在學習輸入綁定時(shí),我們知(zhī)道(dào)了(le) v-model 有一些(xiē)内置的修飾符,例如 .trim,.number 和(hé) .lazy。在某些(xiē)場景下(xià),你(nǐ)可能(néng)想要一個自(zì)定義組件的 v-model 支持自(zì)定義的修飾符。

我們來(lái)創建一個自(zì)定義的修飾符 capitalize,它會(huì)自(zì)動将 v-model 綁定輸入的字符串值第一個字母轉爲大(dà)寫:

template

<MyComponent v-model.capitalize="myText" />

組件的 v-model 上(shàng)所添加的修飾符,可以通過 modelModifiers prop 在組件内訪問到(dào)。在下(xià)面的組件中,我們聲明(míng)了(le) modelModifiers 這(zhè)個 prop,它的默認值是一個空(kōng)對(duì)象:

vue

<script>

export default {

props: {

modelValue: String,

modelModifiers: {

default: () => ({})

}

},

emits: ['update:modelValue'],

created() {

console.log(this.modelModifiers) // { capitalize: true }

}

}

</script>

<template>

<input

type="text"

:value="modelValue"

@input="$emit('update:modelValue', $event.target.value)"

/>

</template>

注意這(zhè)裏組件的 modelModifiers prop 包含了(le) capitalize 且其值爲 true,因爲它在模闆中的 v-model 綁定 v-model.capitalize="myText" 上(shàng)被使用(yòng)了(le)。

有了(le)這(zhè)個 prop,我們就可以檢查 modelModifiers 對(duì)象的鍵,并編寫一個處理(lǐ)函數來(lái)改變抛出的值。在下(xià)面的代碼裏,我們就是在每次 <input /> 元素觸發 input 事(shì)件時(shí)将值的首字母大(dà)寫:

vue

<script>

export default {

props: {

modelValue: String,

modelModifiers: {

default: () => ({})

}

},

emits: ['update:modelValue'],

methods: {

emitValue(e) {

let value = e.target.value

if (this.modelModifiers.capitalize) {

value = value.charAt(0).toUpperCase() + value.slice(1)

}

this.$emit('update:modelValue', value)

}

}

}

</script>

<template>

<input type="text" :value="modelValue" @input="emitValue" />

</template>

對(duì)于又有參數又有修飾符的 v-model 綁定,生成的 prop 名将是 arg + "Modifiers"。舉例來(lái)說:

template

<MyComponent v-model:title.capitalize="myText">

相應的聲明(míng)應該是:

js

export default {

props: ['title', 'titleModifiers'],

emits: ['update:title'],

created() {

console.log(this.titleModifiers) // { capitalize: true }

}

}

網站(zhàn)建設開(kāi)發|APP設計(jì)開(kāi)發|小(xiǎo)程序建設開(kāi)發
下(xià)一篇:透傳 Attributes
上(shàng)一篇:組件事(shì)件