Escape tuşu kodu
Esc, event.key "Escape", event.code "Escape" ve keyCode 27 gönderir.
Tüm değerler bir bakışta
| Tuş | event.code | event.key | keyCode | event.location |
|---|---|---|---|---|
| Escape | Escape | Escape | 27 | 0 (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
document.addEventListener('keydown', (event) => {
if (event.key === 'Escape') {
// Kodunuz burada
}
});document.addEventListener('keydown', (event) => {
if (event.code === 'Escape') {
// Kodunuz burada
}
});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.