Escape tuşu kodu

Esc, event.key "Escape", event.code "Escape" ve keyCode 27 gönderir.

Tüm değerler bir bakışta

Escape için değerler
Tuşevent.codeevent.keykeyCodeevent.location
EscapeEscapeEscape270 (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 Escape tuşuna basın

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

Escape tuşuna tepki veren kod

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

Hangi değer kullanılmalı

event.key === 'Escape' kontrol edin. Tek bir Esc tuşu vardır ve her düzende aynı değeri gönderir, yani burada event.key ve event.code aynı şeyi söyler. key daha okunaklıdır.

keyCode 27 her tarayıcıda hâlâ gelir, ama kullanımdan kalkmıştır.

Çok eski tarayıcılar "Esc" gönderirdi: Internet Explorer ve Firefox 36 ve öncesi. İkisini de yalnızca bunları hâlâ destekliyorsanız kabul edin.

Sık yapılan hatalar

Esc tam ekrandan çıkarıyor ve işleyicim durduramıyor

Tam ekranda (ve pointer lock’ta) Esc tarayıcıya aittir. Her zaman çıkar ve preventDefault() yardımcı olmaz. İşleyiciniz o Esc’i görmeyebilir bile. Ne zaman olduğunu anlamak için fullscreenchange olayını dinleyin. Chromium’da bir oyun, tam ekrandayken navigator.keyboard.lock(['Escape']) çağırabilir. Kullanıcı o zaman çıkmak için Esc’i basılı tutar.

İptal etmeme rağmen diyalog kapanıyor

Modal bir <dialog> Esc’e basılınca kendiliğinden kapanır. Önce durdurabileceğiniz bir cancel olayı gönderir:

dialog.addEventListener('cancel', (event) => event.preventDefault());

Chrome onu yalnızca bir kez durdurmanıza izin verir: arada hiçbir yere tıklamadan Esc’e tekrar basarsanız yine de kapanır. Bir diyaloğu bilerek açık tutmak için desteklendiği yerde closedby="none" ayarlayın ve kullanıcının işini cancel yerine close olayında kaydedin.

Esc aynı anda iki şeyi kapatıyor

Bir diyaloğun içinde menü açıkken ikisi de aynı Esc’i duyar. Yalnızca en içtekini kapatın: Esc’i menüde işleyin, sonra diyalog kodunuz çalışmasın diye event.stopPropagation() çağırın ve yerel bir <dialog> da kapanmasın diye event.preventDefault() çağırın: kapanma, bir işleyici değil, tarayıcının varsayılan işlemidir.

Arama alanında Esc alanı temizliyor

Chrome’da ve bazı diğer tarayıcılarda Esc bir <input type="search"> alanını boşaltır. Esc arama kutunuzu kapatmalıysa keydown’da preventDefault() çağırın veya temizleme ile kapatmayı tek adımda yapın.

iPad klavyesinde Esc tuşu yok

Bazı iPad klavyelerinde Esc tuşu yoktur, telefonlarda ise hiç yoktur. Her zaman görünen bir kapatma düğmesi de ekleyin. Esc bir kısayoldur, tek çıkış yolu değildir.

Çıkış yolu olarak Esc

Klavye kullanıcıları Esc’in menüleri, açılır pencereleri ve diyalogları kapatmasını ve odağı onları açan düğmeye geri vermesini bekler. Bir kod düzenleyici veya tuş kodu bulucudaki kutu gibi her tuşu yakalayan bir bileşen varsa, Esc’in onu serbest bırakmasına izin verin, böylece Tab yine ilerler. Bu, klavye kullanıcılarının sıkışıp kalmasını önler.