Ok tuşu kodları

Ok tuşları event.key "ArrowLeft", "ArrowUp", "ArrowRight" ve "ArrowDown", keyCode ise 37, 38, 39 ve 40 gönderir.

Tüm değerler bir bakışta

Ok tuşları için değerler
Tuşevent.codeevent.keykeyCodeevent.location
Sol okArrowLeftArrowLeft370 (Standart)
Yukarı okArrowUpArrowUp380 (Standart)
Sağ okArrowRightArrowRight390 (Standart)
Aşağı okArrowDownArrowDown400 (Standart)

Chrome ve Edge'in Windows'ta gönderdiği keyCode. Mac sütunu (Mac'te Chrome ve Safari) ve Firefox sütunu yalnızca farklı olan sayıları gösterir. Aşağıdaki metnin dediği gibi bazı tuşlar sisteme göre de farklıdır. event.which her zaman keyCode ile aynı sayıdır. event.key, Shift olmadan ABD düzeni içindir.

Burada basın

Buraya tıklayın, sonra bir ok tuşuna basın

Yalnızca klavye mi kullanıyorsunuz? Tuş kutusundan çıkmak için Esc'ye, sonra Tab'a basın.

Sol ok tuşuna tepki veren kod

Önerilen: event.key ile eşleştirin
document.addEventListener('keydown', (event) => {
  if (event.key === 'ArrowLeft') {
    // Kodunuz burada
  }
});
Tuşun yerine göre eşleştirin: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'ArrowLeft') {
    // Kodunuz burada
  }
});
Hâlâ keyCode kullanan eski kod (yeni kodda önerilmez)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 37) {
    // Kodunuz burada
  }
});

Hangi değer kullanılmalı

event.key değerine bakın. Ok tuşları klavye düzenine göre değişmez, bu yüzden key ve code aynı adlara sahiptir: ArrowLeft, ArrowUp, ArrowRight ve ArrowDown.

Sayısal tuş takımı sayılmamalıysa event.code kullanın. Num Lock kapalıyken sayısal tuş takımındaki 4, 8, 6 ve 2 tuşları da key “ArrowLeft”, “ArrowUp”, “ArrowRight” ve “ArrowDown” ile sırasıyla keyCode 37, 38, 39 ve 40 gönderir. Onları yalnızca code değerleri (Numpad4, Numpad8, Numpad6, Numpad2) ve location 3 ele verir.

Eski sayılar soldan başlayıp saat yönünde ilerler: 37 Sol, 38 Yukarı, 39 Sağ, 40 Aşağı. Her tarayıcı bunları hâlâ gönderir, ama kullanımdan kalkmışlardır.

Sık yapılan hatalar

Oyuncu ok tuşuna basınca sayfa kayıyor

Kaydırma, ok tuşlarının varsayılan işlemidir. keydown olayında event.preventDefault() çağırın. Dinleyiciyi window yerine oyunun kendisine ekleyin (ona tabindex="0" verin). Böylece sayfanın geri kalanı yine kayar ve metin alanlarında imleç hareket eder:

game.addEventListener('keydown', (event) => {
  if (event.key.startsWith('Arrow')) event.preventDefault();
});

Hareket takılıyor veya bir yön basılı kalıyor

Basılı tutulan tuş bir keydown gönderir, biraz bekler, sonra kullanıcının tekrar hızıyla tekrarlar. Her keydown’da hareket etmek takılma yapar. Bunun yerine basılı tuşların bir kümesini tutun: keydown’da event.code ekleyin, keyup’ta silin ve oyun döngünüzde hareket edin. Kümeyi pencerenin blur olayında boşaltın: kullanıcı bir tuşu basılı tutarken pencere değiştirirse keyup sayfanıza hiç ulaşmaz.

Eski kod “Left” veya “Up” arıyor

Internet Explorer, Edge 16 ve öncesi, Firefox 36 ve öncesi "Left", "Up", "Right" ve "Down" gönderirdi. Güncel tarayıcılar Arrow adlarını gönderir. İkisini de yalnızca bu tarayıcıları hâlâ destekliyorsanız kontrol edin.

Ok tuşu kodunuz bir kaydırıcı, liste veya metin alanıyla çakışıyor

Birçok öğe ok tuşlarını kendisi kullanır: metin alanlarında imleç hareket eder, kaydırıcılar değerini değiştirir, radyo düğmeleri ve <select> seçimi değiştirir. event.target bunlardan biriyse olayı atlayın veya önce onların tuşu işlemesine izin verip event.defaultPrevented değerine bakın.

Mac ve laptop klavyeleri

Mac laptoplarda ve birçok küçük klavyede Home, End, Page Up ve Page Down tuşları yoktur. Mac’te bunun yerine bir ok tuşuyla birlikte Fn tuşunu basılı tutun: Fn + Sol Home, Fn + Sağ End, Fn + Yukarı Page Up ve Fn + Aşağı Page Down gönderir. Sayfa ok tuşunu değil, bu tuşları alır.

Mac’te Cmd basılıyken basılan bir ok tuşunun keyup olayı hiçbir tarayıcıda gelmeyebilir. Basılı tuş durumu için buna güvenmeyin.