Bileşende v-model
Temel Kullanım
v-model, bir bileşende iki yönlü bağlama uygulamak için kullanılabilir.
Vue 3.4 itibarıyla bunu başarmanın önerilen yolu, defineModel() makrosunu kullanmaktır:
vue
<script setup>
const model = defineModel()
function update() {
model.value++
}
</script>
<template>
<div>Parent bound v-model is: {{ model }}</div>
<button @click="update">Increment</button>
</template>Üst bileşen ardından bir değeri v-model ile bağlayabilir:
template
<Child v-model="countModel" />defineModel() tarafından döndürülen değer bir ref’tir. Herhangi bir ref gibi erişilebilir ve değiştirilebilir; ancak üst bileşendeki bir değer ile yerel değer arasında iki yönlü bağlama oluşturur:
.valuedeğeri, üst bileşendekiv-modelile bağlanan değerle eşitlenir;- Alt bileşen tarafından değiştirildiğinde, üst bileşendeki bağlanan değerin de güncellenmesini sağlar.
Bu ref’i yerleşik bir input öğesine de v-model ile bağlayabileceğiniz anlamına gelir; böylece yerleşik input'ları sarmalarken aynı v-model kullanımını sunmak kolaylaşır:
vue
<script setup>
const model = defineModel()
</script>
<template>
<input v-model="model" />
</template>Arka planda
defineModel, kullanışlı bir makrodur. Derleyici bunu aşağıdakilere dönüştürür:
- Yerel ref’in değeriyle eşitlenen
modelValueadlı bir prop; - Yerel ref’in değeri değiştirildiğinde tetiklenen
update:modelValueadlı bir olay.
Yukarıda gösterilen aynı alt bileşen, 3.4 öncesinde şu şekilde uygulanırdı:
vue
<script setup>
const props = defineProps(['modelValue'])
const emit = defineEmits(['update:modelValue'])
</script>
<template>
<input
:value="props.modelValue"
@input="emit('update:modelValue', $event.target.value)"
/>
</template>Ardından, üst bileşendeki v-model="foo" ifadesi şuna derlenir:
template
<Child
:modelValue="foo"
@update:modelValue="$event => (foo = $event)"
/>Gördüğünüz gibi bu çok daha uzundur. Ancak, arka planda neler olduğunu anlamak faydalıdır.
defineModel bir prop bildirdiğinden, altta yatan prop’un seçeneklerini defineModel’e ileterek bildirebilirsiniz:
js
// v-model'i zorunlu yapma
const model = defineModel({ required: true })
// varsayılan değer atama
const model = defineModel({ default: 0 })Uyarı
defineModel prop’u için bir default değeriniz varsa ve üst bileşenden bu prop için hiçbir değer iletmezseniz, üst ve alt bileşenler arasında senkronizasyon bozulmasına neden olabilir. Aşağıdaki örnekte üst bileşendeki myRef tanımsızdır, ancak alt bileşendeki model değeri 1’dir:
vue
<script setup>
const model = defineModel({ default: 1 })
</script>vue
<script setup>
const myRef = ref()
</script>
<template>
<Child v-model="myRef"></Child>
</template>v-model Argümanları
Bir bileşendeki v-model bir argüman da alabilir:
template
<MyComponent v-model:title="bookTitle" />Alt bileşende, karşılık gelen argümanı desteklemek için defineModel() fonksiyonunun ilk argümanı olarak bir string değer iletebiliriz:
vue
<script setup>
const title = defineModel('title')
</script>
<template>
<input type="text" v-model="title" />
</template>Prop seçenekleri de gerekiyorsa, model adından sonra iletilmelidir:
js
const title = defineModel('title', { required: true })3.4 Öncesi Kullanım
vue
<script setup>
defineProps({
title: {
required: true
}
})
defineEmits(['update:title'])
</script>
<template>
<input
type="text"
:value="title"
@input="$emit('update:title', $event.target.value)"
/>
</template>Birden Fazla v-model Bağlaması
Daha önce v-model argümanları ile belirli bir prop ve olayı hedefleme konusunda öğrendiğimiz bilgileri kullanarak, tek bir bileşen örneğinde birden fazla v-model bağlaması oluşturabiliriz.
Her v-model, bileşende ek seçenek gerekmeden farklı bir prop ile eşitlenir:
template
<UserName
v-model:first-name="first"
v-model:last-name="last"
/>vue
<script setup>
const firstName = defineModel('firstName')
const lastName = defineModel('lastName')
</script>
<template>
<input type="text" v-model="firstName" />
<input type="text" v-model="lastName" />
</template>3.4 Öncesi Kullanım
vue
<script setup>
defineProps({
firstName: String,
lastName: String
})
defineEmits(['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>v-model Değiştiricilerini İşleme
Form input bağlamalarını incelerken, v-model’in yerleşik değiştiricilere sahip olduğunu görmüştük: .trim, .number ve .lazy. Bazı durumlarda özel input bileşeninizdeki v-model’in özel değiştiricileri desteklemesini de isteyebilirsiniz.
Özel bir değiştirici örneği olan capitalize ile v-model bağlamasının sağladığı string değerin ilk harfini büyütelim:
template
<MyComponent v-model.capitalize="myText" />Bileşen v-model’ine eklenen değiştiricilere, alt bileşende defineModel() dönüş değerini şu şekilde parçalayarak erişebilirsiniz:
vue
<script setup>
const [model, modifiers] = defineModel()
console.log(modifiers) // { capitalize: true }
</script>
<template>
<input type="text" v-model="model" />
</template>Değiştiricilere göre değerin nasıl okunup yazılacağını koşullu olarak ayarlamak için defineModel()’e get ve set seçeneklerini iletebilirsiniz. Bu iki seçenek model ref’inin okunması ve yazılması sırasında gelen değeri alır ve dönüştürülmüş bir değer döndürmelidir. capitalize değiştiricisini uygulamak için set seçeneğini şöyle kullanabilirsiniz:
vue
<script setup>
const [model, modifiers] = defineModel({
set(value) {
if (modifiers.capitalize) {
return value.charAt(0).toUpperCase() + value.slice(1)
}
return value
}
})
</script>
<template>
<input type="text" v-model="model" />
</template>3.4 Öncesi Kullanım
vue
<script setup>
const props = defineProps({
modelValue: String,
modelModifiers: { default: () => ({}) }
})
const emit = defineEmits(['update:modelValue'])
function emitValue(e) {
let value = e.target.value
if (props.modelModifiers.capitalize) {
value = value.charAt(0).toUpperCase() + value.slice(1)
}
emit('update:modelValue', value)
}
</script>
<template>
<input type="text" :value="props.modelValue" @input="emitValue" />
</template>Argümanlı v-model için Değiştiriciler
Farklı argümanlara sahip birden fazla v-model ile değiştirici kullanımına ilişkin bir başka örnek:
template
<UserName
v-model:first-name.capitalize="first"
v-model:last-name.uppercase="last"
/>vue
<script setup>
const [firstName, firstNameModifiers] = defineModel('firstName')
const [lastName, lastNameModifiers] = defineModel('lastName')
console.log(firstNameModifiers) // { capitalize: true }
console.log(lastNameModifiers) // { uppercase: true }
</script>3.4 Öncesi Kullanım
vue
<script setup>
const props = defineProps({
firstName: String,
lastName: String,
firstNameModifiers: { default: () => ({}) },
lastNameModifiers: { default: () => ({}) }
})
defineEmits(['update:firstName', 'update:lastName'])
console.log(props.firstNameModifiers) // { capitalize: true }
console.log(props.lastNameModifiers) // { uppercase: true }
</script>