Skip to content

Olay İşleme ​

Olayları Dinleme ​

v-on direktifini (genellikle @ sembolüyle kısaltılır) DOM olaylarını dinlemek ve tetiklendiğinde JavaScript çalıştırmak için kullanabiliriz. Kullanımı v-on:click="handler" ya da kısaca @click="handler" şeklindedir. Handler değeri aşağıdakilerden biri olabilir:

Handler değeri aşağıdakilerden biri olabilir:

  1. Inline handler’lar (işleyiciler): Olay tetiklendiğinde çalıştırılan inline JavaScript (native onclick attribute’una benzer).

  2. Metot handler’ları (işleyiciler): Component üzerinde tanımlı bir metoda işaret eden property adı veya path.

Inline Handlers ​

Inline handler’lar genellikle basit durumlarda kullanılır. Örneğin:

js
const count = ref(0)
js
data() {
  return {
    count: 0
  }
}
template
<button @click="count++">1 Arttır</button>
<p>Sayaç: {{ count }}</p>

Method Handlers ​

Ancak birçok olay handler’ının mantığı daha karmaşık olacaktır ve bu tür durumlar inline handler’lar ile genellikle uygun değildir. Bu nedenle v-on, çağırmak istediğiniz bir component metodunun adını veya yolunu da kabul eder.

Örneğin:

js
const name = ref('Vue.js')

function greet(event) {
  alert(`Merhaba ${name.value}!`)
  // `event`, native DOM event nesnesidir
  if (event) {
    alert(event.target.tagName)
  }
}
js
data() {
  return {
    name: 'Vue.js'
  }
},
methods: {
  greet(event) {
    // metotlar içindeki `this`, mevcut aktif instance’ı işaret eder
    alert(`Merhaba ${this.name}!`)
    // `event`, native DOM event nesnesidir
    if (event) {
      alert(event.target.tagName)
    }
  }
}
template
<!-- `greet`, yukarıda tanımlanan metodun adıdır -->
<button @click="greet">Selamla</button>

Bir metot handler’ı, kendisini tetikleyen native DOM Event nesnesini otomatik olarak alır — yukarıdaki örnekte, event.target aracılığıyla olayı tetikleyen elemente erişebiliyoruz.

Metot vs Inline Tespiti ​

Template compiler, v-on değerinin geçerli bir JavaScript tanımlayıcısı (identifier) veya özellik erişim yolu (property access path) olup olmadığını kontrol ederek metot handler’larını tespit eder. Örneğin foo, foo.bar ve foo['bar'] metot handler olarak değerlendirilirken, foo() ve count++ inline handler olarak değerlendirilir.

Inline Handler’larda Metot Çağırma ​

Doğrudan bir metot adına bağlamak yerine, inline handler içinde metotları da çağırabiliriz. Bu, native event yerine metoda özel argümanlar geçmemize olanak sağlar:

js
function say(message) {
  alert(message)
}
js
methods: {
  say(message) {
    alert(message)
  }
}
template
<button @click="say('hello')">Merhaba de</button>
<button @click="say('bye')">Güle güle de</button>

Inline Handler’larda Event Argümanına Erişim ​

Bazen inline handler içinde orijinal DOM event’e de erişmemiz gerekir. Bunu, özel $event değişkenini kullanarak metoda geçirebilir veya inline arrow function kullanabiliriz:

template
<!-- özel `$event` değişkeni kullanılarak -->
<button @click="warn('Form henüz gönderilemez.', $event)">
  Gönder
</button>

<!-- inline arrow function kullanılarak -->
<button @click="(event) => warn('Form henüz gönderilemez.', event)">
  Gönder
</button>
js
function warn(message, event) {
  // artık native event’e erişimimiz var
  if (event) {
    event.preventDefault()
  }
  alert(message)
}
js
methods: {
  warn(message, event) {
    // artık native event nesnesine erişimimiz var
    if (event) {
      event.preventDefault()
    }
    alert(message)
  }
}

Olay Değiştiricileri ​

Olay işleyicileri içinde event.preventDefault() veya event.stopPropagation() çağırmak oldukça yaygın bir ihtiyaçtır. Bunu metotlar içinde kolayca yapabilsek de, metotların DOM event detaylarıyla uğraşmak yerine yalnızca veri mantığına odaklanması daha iyi olur.

Bu sorunu çözmek için Vue, v-on için event değiştiricileri sağlar. Hatırlarsanız, değiştiriciler nokta ile belirtilen direktif ekleridir.

  • .stop
  • .prevent
  • .self
  • .capture
  • .once
  • .passive
template
<!-- tıklama olayının yayılması durdurulur -->
<a @click.stop="doThis"></a>

<!-- form gönderme olayı artık sayfayı yeniden yüklemez -->
<form @submit.prevent="onSubmit"></form>

<!-- değiştiriciler zincirlenebilir -->
<a @click.stop.prevent="doThat"></a>

<!-- sadece değiştirici -->
<form @submit.prevent></form>

<!-- işleyiciler yalnızca event.target elementin kendisi olduğunda tetiklenir -->
<!-- yani bir alt elementten gelmez -->
<div @click.self="doThat">...</div>

TIP

Değiştiriciler kullanılırken sıralama önemlidir, çünkü ilgili kod aynı sırayla oluşturulur. Bu nedenle @click.prevent.self kullanımı, click’in varsayılan davranışını hem elementin kendisi hem de alt elementleri için engeller, @click.self.prevent ise yalnızca elementin kendisi için click’in varsayılan davranışını engeller.

.capture, .once ve .passive değiştiricileri, native addEventListener metodunun seçeneklerini yansıtır:

template
<!-- olay dinleyicisi eklenirken capture modu kullanılır -->
<!-- yani içteki bir elemana hedeflenen olay -->
<!-- önce burada işlenir, sonra o elemana geçer -->
<div @click.capture="doThis">...</div>

<!-- click olayı en fazla bir kez tetiklenir -->
<a @click.once="doThis"></a>

<!-- scroll olayının varsayılan davranışı (kaydırma) hemen gerçekleşir -->
<!-- onScroll tamamlanmasını beklemez -->
<!-- içinde event.preventDefault() olsa bile -->
<div @scroll.passive="onScroll">...</div>

.passive değiştiricisi genellikle mobil cihazlarda performansı artırmak için touch event dinleyicileriyle birlikte kullanılır.

TIP

.passive ve .prevent birlikte kullanılmamalıdır, çünkü .passive zaten tarayıcıya olayın varsayılan davranışını engellemeyi düşünmediğinizi bildirir ve bunu yaparsanız büyük olasılıkla tarayıcıdan bir uyarı alırsınız.

Tuş Değiştiricileri ​

Klavye olaylarını dinlerken, genellikle belirli tuşları kontrol etmemiz gerekir. Vue, tuş olaylarını dinlerken v-on veya @ için tuş değiştiricileri eklememize olanak tanır:

template
<!-- yalnızca `key` değeri `Enter` olduğunda `submit` çağrılır -->
<input @keyup.enter="submit" />

KeyboardEvent.key üzerinden sağlanan geçerli tuş adlarını kebab-case’e dönüştürerek doğrudan değiştirici olarak kullanabilirsiniz.

template
<input @keyup.page-down="onPageDown" />

Yukarıdaki örnekte, handler yalnızca $event.key değeri 'PageDown' olduğunda çağrılır.+

Tuş Takma Adları ​

Vue, en sık kullanılan tuşlar için takma adlar sağlar:

  • .enter
  • .tab
  • .delete ("Delete" ve "Backspace" tuşlarının her ikisini de kapsar)
  • .esc
  • .space
  • .up
  • .down
  • .left
  • .right

Sistem Değiştirici Tuşlar ​

Aşağıdaki değiştiricileri, mouse veya klavye olay dinleyicilerini yalnızca ilgili değiştirici tuş basılıyken tetiklemek için kullanabilirsiniz:

  • .ctrl
  • .alt
  • .shift
  • .meta

Note

Macintosh klavyelerde meta, command tuşudur (⌘). Windows klavyelerde meta, Windows tuşudur (⊞). Sun Microsystems klavyelerinde meta, dolu elmas (◆) ile gösterilir. MIT ve Lisp machine klavyeleri ile bunların devamı olan Knight keyboard ve space-cadet keyboard gibi bazı klavyelerde meta tuşu “META” olarak etiketlenir. Symbolics klavyelerinde ise meta “META” veya “Meta” olarak etiketlenir.

Örneğin:

template
<!-- Alt + Enter -->
<input @keyup.alt.enter="clear" />

<!-- Ctrl + Click -->
<div @click.ctrl="doSomething">Bir şey yap</div>

TIP

Modifier tuşlarının normal tuşlardan farklı olduğunu unutmayın ve keyup olaylarıyla kullanıldığında, olay tetiklendiği anda basılı olmaları gerekir. Başka bir deyişle, keyup.ctrl yalnızca Ctrl tuşuna basılı tutarken bir tuşu bıraktığınızda tetiklenir. Ctrl tuşunu tek başına bıraktığınızda tetiklenmez.

.exact Değiştiricisi ​

.exact değiştiricisi, bir olayın tetiklenmesi için gereken sistem değiştiricilerinin tam kombinasyonunu kontrol etmenizi sağlar.

template
<!-- Alt veya Shift basılı olsa bile tetiklenir -->
<button @click.ctrl="onClick">A</button>

<!-- yalnızca Ctrl basılıyken ve başka hiçbir tuş basılı değilken tetiklenir -->
<button @click.ctrl.exact="onCtrlClick">A</button>

<!-- yalnızca hiçbir sistem değiştirici tuş basılı değilken tetiklenir -->
<button @click.exact="onClick">A</button>

Mouse Düğmesi Değiştiricileri ​

  • .left
  • .right
  • .middle

Bu değiştiriciler, handler’ın yalnızca belirli bir mouse düğmesi tarafından tetiklenen olaylara tepki vermesini sağlar.

Ancak .left, .right ve .middle değiştirici adları fiziksel mouse tuşlarını birebir ifade etmez; yaygın sağ el düzenine göre tanımlanan “ana”, “ikincil” ve “yardımcı” işaretçi olaylarını temsil eder. Bu nedenle solak bir düzende ana düğme fiziksel olarak sağ tarafta olsa bile .left değiştiricisini tetikler. Benzer şekilde trackpad gibi farklı giriş aygıtlarında tek parmak dokunuş .left, iki parmak dokunuş .right, üç parmak dokunuş ise .middle olarak yorumlanabilir. Genel olarak bu olaylar, kullanılan cihazdan bağımsız şekilde sol/sağ gibi fiziksel konumlara değil, işlevsel rollere dayanır.

Olay İşleme has loaded