Skip to content

Bileşen Olayları ​

Bu sayfa, Bileşenlerin Temelleri'ni okuduğunuzu varsayar. Bileşenlere yeniyseniz, önce bunu okuyun.

Olayları Tetikleme ve Dinleme ​

Bir bileşen, yerleşik $emit fonksiyonunu kullanarak özel olayları doğrudan template (şablon) ifadeleri içinde (örneğin bir v-on işleyicisinde) tetikleyebilir:

template
<!-- MyComponent -->
<button @click="$emit('someEvent')">Click Me</button>

$emit() fonksiyonu, bileşen örneğinde this.$emit() olarak da kullanılabilir:

js
export default {
  methods: {
    submit() {
      this.$emit('someEvent')
    }
  }
}

Üst bileşen daha sonra bunu v-on kullanarak dinleyebilir:

template
<MyComponent @some-event="callback" />

.once değiştiricisi, bileşen olay dinleyicilerinde de desteklenir:

template
<MyComponent @some-event.once="callback" />

Bileşenlerde ve props’larda olduğu gibi, olay adları da otomatik bir büyük/küçük harf dönüşümü sağlar. Dikkat ederseniz, camelCase ile yazılmış bir olay tetikledik; ancak üst bileşende bunu kebab-case ile yazılmış bir dinleyici ile dinleyebiliyoruz. Props İsimlendirme Stili'nde olduğu gibi, template’lerde (şablonlarda) kebab-case olay dinleyicileri kullanmanızı öneririz.

İpucu

Yerleşik DOM olaylarının aksine, bileşen tarafından tetiklenen olaylar yukarı doğru yayılmaz (bubble olmaz). Yalnızca doğrudan alt bileşen tarafından tetiklenen olayları dinleyebilirsiniz. Aynı seviyedeki veya derin şekilde iç içe geçmiş bileşenler arasında iletişim gerekiyorsa, harici bir event bus ya da küresel durum yönetimi çözümü kullanın.

Olay Argümanları ​

Bazen bir olayla birlikte belirli bir değeri iletmek faydalı olabilir. Örneğin, <BlogPost> bileşeninin metni ne kadar büyüteceğini kendisinin belirlemesini isteyebiliriz. Bu gibi durumlarda, bu değeri iletmek için $emit fonksiyonuna ek argümanlar ekleyebiliriz:

template
<button @click="$emit('increaseBy', 1)">
  Increase by 1
</button>

Ardından, üst bileşende olayı dinlerken, dinleyici olarak satır içi bir ok fonksiyonu kullanabiliriz; bu sayede olay argümanına erişebiliriz:

template
<MyButton @increase-by="(n) => count += n" />

Ya da olay işleyicisi bir fonksiyonsa:

template
<MyButton @increase-by="increaseCount" />

Bu durumda değer, ilgili fonksiyonun ilk parametresi olarak iletilir:

js
methods: {
  increaseCount(n) {
    this.count += n
  }
}
js
function increaseCount(n) {
  count.value += n
}

İpucu

Olay adından sonra $emit() fonksiyonuna eklenen tüm ek argümanlar dinleyiciye iletilir. Örneğin, $emit('foo', 1, 2, 3) kullanıldığında dinleyici fonksiyonu üç argüman alır.

Tetiklenen Olayların Bildirilmesi ​

Bir bileşen, tetikleyeceği olayları açıkça defineEmits() makrosunuemits seçeneğini kullanarak bildirebilir:

vue
<script setup>
defineEmits(['inFocus', 'submit'])
</script>

<template> içinde kullandığımız $emit fonksiyonuna, bir bileşenin <script setup> bölümünde doğrudan erişilemez; ancak defineEmits() bunun yerine kullanabileceğimiz eşdeğer bir fonksiyon döndürür:

vue
<script setup>
const emit = defineEmits(['inFocus', 'submit'])

function buttonClick() {
  emit('submit')
}
</script>

defineEmits() makrosu bir fonksiyon içinde kullanılamaz; yukarıdaki örnekte olduğu gibi doğrudan <script setup> içinde yer almalıdır.

Eğer <script setup> yerine açık bir setup fonksiyonu kullanıyorsanız, olaylar emits seçeneği ile bildirilmelidir ve emit fonksiyonu setup() bağlamı üzerinden erişilebilir:

js
export default {
  emits: ['inFocus', 'submit'],
  setup(props, ctx) {
    ctx.emit('submit')
  }
}

setup() bağlamındaki diğer özelliklerde olduğu gibi, emit güvenli bir şekilde ayrıştırılabilir:

js
export default {
  emits: ['inFocus', 'submit'],
  setup(props, { emit }) {
    emit('submit')
  }
}
js
export default {
  emits: ['inFocus', 'submit']
}

emits seçeneği ve defineEmits() makrosu ayrıca nesne söz dizimini de destekler. TypeScript kullanıyorsanız, argümanlara tip atayabilirsiniz; bu da tetiklenen olayların payload’ı için çalışma zamanında doğrulama yapmamıza olanak tanır:

vue
<script setup lang="ts">
const emit = defineEmits({
  submit(payload: { email: string, password: string }) {
    // doğrulamanın başarılı / başarısız olduğunu
    // belirtmek için `true` veya `false` döndürülür
  }
})
</script>

Eğer <script setup> ile TypeScript kullanıyorsanız, tetiklenen olayları yalnızca tip tanımlamaları kullanarak da bildirebilirsiniz:

vue
<script setup lang="ts">
const emit = defineEmits<{
  (e: 'change', id: number): void
  (e: 'update', value: string): void
}>()
</script>

Daha fazla detay: Bileşen Emit’lerinin Tiplenmesi

js
export default {
  emits: {
    submit(payload: { email: string, password: string }) {
      // doğrulamanın başarılı / başarısız olduğunu
      // belirtmek için `true` veya `false` döndürülür
    }
  }
}

Ayrıca göz atın: Bileşen Emit’lerinin Tiplenmesi

Her ne kadar zorunlu olmasa da, bir bileşenin nasıl çalışması gerektiğini daha iyi belgelemek için tüm tetiklenen olayların tanımlanması önerilir. Ayrıca Vue’nün, bilinen dinleyicileri aktarılacak öznitelikler (fallthrough attributes) kapsamından hariç tutmasını sağlar ve böylece üçüncü parti kodlar tarafından manuel olarak tetiklenen DOM olaylarının neden olabileceği uç durumları önler.

İpucu

Eğer emits seçeneğinde yerleşik bir olay (örneğin click) tanımlanmışsa, dinleyici artık yalnızca bileşen tarafından tetiklenen click olaylarını dinler ve yerleşik click olaylarına yanıt vermez.

Olay Doğrulama ​

Prop tip doğrulamasında olduğu gibi, bir tetiklenen olay da dizi söz dizimi yerine nesne söz dizimi ile tanımlandığında doğrulanabilir.

Doğrulama eklemek için olaya, this.$emitemit çağrısına eklenen argümanları alan ve olayın geçerli olup olmadığını belirtmek için bir boolean değer döndüren bir fonksiyon atanır.

vue
<script setup>
const emit = defineEmits({
  // Doğrulama yok
  click: null,

  // submit olayının doğrulanması
  submit: ({ email, password }) => {
    if (email && password) {
      return true
    } else {
      console.warn('Invalid submit event payload!')
      return false
    }
  }
})

function submitForm(email, password) {
  emit('submit', { email, password })
}
</script>
js
export default {
  emits: {
    // Doğrulama yok
    click: null,

    // submit olayının doğrulanması
    submit: ({ email, password }) => {
      if (email && password) {
        return true
      } else {
        console.warn('Invalid submit event payload!')
        return false
      }
    }
  },
  methods: {
    submitForm(email, password) {
      this.$emit('submit', { email, password })
    }
  }
}
Bileşen Olayları has loaded