Harf tuşu kodları (A–Z)

Harf tuşları ABD düzeninde event.code olarak "KeyA" ile "KeyZ", event.key olarak "a" ile "z" (Shift ya da Caps Lock ile "A"–"Z") ve keyCode olarak 65 ile 90 gönderir.

Tüm değerler bir bakışta

Harfler A–Z için değerler
Tuşevent.codeevent.keykeyCodeevent.location
AKeyAa650 (Standart)
BKeyBb660 (Standart)
CKeyCc670 (Standart)
DKeyDd680 (Standart)
EKeyEe690 (Standart)
FKeyFf700 (Standart)
GKeyGg710 (Standart)
HKeyHh720 (Standart)
IKeyIi730 (Standart)
JKeyJj740 (Standart)
KKeyKk750 (Standart)
LKeyLl760 (Standart)
MKeyMm770 (Standart)
NKeyNn780 (Standart)
OKeyOo790 (Standart)
PKeyPp800 (Standart)
QKeyQq810 (Standart)
RKeyRr820 (Standart)
SKeySs830 (Standart)
TKeyTt840 (Standart)
UKeyUu850 (Standart)
VKeyVv860 (Standart)
WKeyWw870 (Standart)
XKeyXx880 (Standart)
YKeyYy890 (Standart)
ZKeyZz900 (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 harf tuşuna basın

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

A tuşuna tepki veren kod

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

Hangi değer kullanılmalı

Önemli olan harf mi, yoksa klavyedeki yer mi, ona bağlıdır.

Yazılan harfler ve bir harfle anılan kısayollar için, örneğin geri almak için Ctrl + Z, event.key değerini kontrol edin. Bu değer kullanıcının düzenini izler, yani kısayol üzerinde Z yazan tuşta çalışır.

Yerine göre seçilen tuşlar için, örneğin bir oyundaki WASD, event.code değerini kontrol edin. KeyW her düzende S’nin üstündeki tuştur, “z” yazan Fransızca AZERTY klavyede bile.

keyCode, büyük harfin numarasıdır: A için 65’ten Z için 90’a kadar, Shift ile de Shift olmadan da. Latin düzenlerinde genellikle yazılan harfi izler: AZERTY’de KeyQ koduna sahip tuş “a” yazar ve 65 gönderir. Rusça, Yunanca ve diğer Latin olmayan düzenlerde genellikle o yerdeki ABD harfidir.

Sık yapılan hatalar

event.key “a” yerine “A” oluyor

Shift ve Caps Lock event.key değerini değiştirir. Küçük harfle karşılaştırın, event.key.toLowerCase() === 'a', Shift önemliyse event.shiftKey değerini ayrıca kontrol edin. Bu, Cmd + Shift + Z’nin küçük harfli bir “z” olarak gelebildiği Mac’te de işe yarar.

Türkçe Q klavyede ı ve i

Türkçe Q klavyede ç, ğ, ı, ö, ş ve ü tuşları vardır. KeyI tuşu “ı” yazar, “i” yazan tuşun kodu ise Quote’tur. Shift ile KeyI “I”, Quote ise “İ” verir. JavaScript’te "I".toLowerCase() Türkçe kurallarına bakmadan “i” verir, bu yüzden event.key.toLowerCase() === 'i' kontrolü KeyI tuşunda yanlış çalışır. "İ".toLowerCase() ise iki karakterli bir sonuç verir. Harf kısayollarını bu iki tuşta event.code ile eşleştirin ya da event.key.toLocaleLowerCase('tr') kullanın. Bu sayfadaki event.code değerleri her düzende aynıdır.

WASD kontrolleri Fransızca klavyede çalışmıyor

event.key === 'w' kontrolü yaparsanız AZERTY oyuncuları sol alttaki W’ye uzanmak zorunda kalır. Tuşların aynı yerde kalması için event.code değerini kontrol edin (KeyW, KeyA, KeyS, KeyD). Yardım metninizde doğru harfleri göstermek için Chrome ve Edge bir kodun ne yazdığını söyleyebilir: navigator.keyboard.getLayoutMap().

Ctrl+Z Almanca ya da Fransızca klavyelerde yanlış tuşa denk geliyor

Almanca QWERTZ düzeni Z ile Y’yi değiştirir, AZERTY’de ise Z, ABD klavyesinde W’nin olduğu yerdedir. event.code === 'KeyZ' ile kontrol edilen bir kısayol, Alman kullanıcıların üzerinde Y yazan tuşa basmasına yol açar. Harf kısayollarını event.key ile eşleştirin.

Kısayollar Rusça ya da Yunanca düzende çalışmayı bırakıyor

Orada event.key, o alfabenin harfidir: Rusça düzende Ctrl + Z “я” gönderir. Tuş Latin harfi değilse yere göre eşleştirmeye geçin:

const letter = /^[a-z]$/i.test(event.key)
  ? event.key.toLowerCase()
  : event.code.startsWith('Key') ? event.code.slice(3).toLowerCase() : '';

Mac’te Alt+harf bir karakter yazıyor

Option + S “ß” yazar, yani event.key “s” değil “ß” olur. Option + E ölü bir tuştur: event.key “Dead” olur ve sonraki harf aksan alır. Alt kısayollarını event.code ve event.altKey ile eşleştirin. Windows’ta AltGr bulunan düzenler Ctrl + Alt ile aynısını yapar: Almanca klavyede Ctrl + Alt + E € yazar, bu yüzden Ctrl + Alt + harf kısayollarından kaçının.