Kod klawisza Caps Lock

Caps Lock wysyła event.key "CapsLock", event.code "CapsLock" i keyCode 20.

Wszystkie wartości w skrócie

Caps Lock – wartości
Klawiszevent.codeevent.keykeyCodeevent.location
Caps LockCapsLockCapsLock200 (Zwykły)

keyCode tak, jak wysyłają go Chrome i Edge w systemie Windows. Kolumny Mac (Chrome i Safari na Macu) i Firefox pokazują tylko liczby, które się różnią. Niektóre klawisze różnią się też zależnie od systemu, jak opisano niżej. event.which to zawsze ta sama liczba co keyCode. event.key dotyczy układu US bez wciśniętego klawisza Shift.

Naciśnij go tutaj

Kliknij tutaj, a potem naciśnij Caps Lock

Używasz tylko klawiatury? Naciśnij Esc, a potem Tab, aby wyjść z pola klawiszy.

Kod, który reaguje na klawisz: Caps Lock

Zalecane: dopasuj event.key
document.addEventListener('keydown', (event) => {
  if (event.key === 'CapsLock') {
    // Twój kod tutaj
  }
});
Rozpoznaj klawisz po jego położeniu: event.code
document.addEventListener('keydown', (event) => {
  if (event.code === 'CapsLock') {
    // Twój kod tutaj
  }
});
Stary kod, który nadal używa keyCode (jego używanie nie jest już zalecane)
document.addEventListener('keydown', (event) => {
  if (event.keyCode === 20) {
    // Twój kod tutaj
  }
});

Której wartości użyć

Aby wiedzieć, czy Caps Lock jest włączony, nie obserwuj samego klawisza. Odczytaj stan z dowolnego zdarzenia klawisza lub myszy: event.getModifierState('CapsLock') ma wartość true, gdy jest włączony. Działa to także wtedy, gdy Caps Lock włączono przed załadowaniem strony.

Aby reagować na sam klawisz, sprawdź event.key === 'CapsLock' (event.code jest taki sam). keyCode to 20, ale jest wycofywany.

Caps Lock zmienia event.key dla liter („A” zamiast „a”), ale nie zmienia event.code ani keyCode.

Co sprawia kłopoty

Ostrzeżenie „Caps Lock jest włączony” pojawia się w niewłaściwym momencie

Liczenie naciśnięć Caps Lock zawodzi, gdy był włączony przed otwarciem strony. Zamiast tego odczytuj stan z każdego zdarzenia w polu hasła:

function checkCaps(event) {
  warning.hidden = !event.getModifierState('CapsLock');
}
password.addEventListener('keydown', checkCaps);
password.addEventListener('keyup', checkCaps);

Ukrywaj ostrzeżenie przy blur. Stan jest znany dopiero po naciśnięciu klawisza lub ruchu myszą: nie da się go sprawdzić przy ładowaniu strony.

Na Macu Caps Lock wysyła tylko jedno zdarzenie

W Windows i Linuksie Caps Lock wysyła keydown i keyup jak każdy klawisz. Na Macu Chrome i Safari wysyłają tylko keydown przy włączeniu i tylko keyup przy wyłączeniu. Firefox na Macu wysyła za każdym razem tylko keydown. Dlatego kod ostrzeżenia nasłuchuje obu zdarzeń.

Zdarzenie klawisza Caps Lock może pokazywać poprzedni stan

Podczas samego zdarzenia Caps Lock przeglądarki różnią się tym, czy getModifierState pokazuje już nowy stan. Sprawdź go ponownie przy następnym klawiszu albo przy keyup.

Krótkie stuknięcie nie włącza go (Mac)

macOS ignoruje bardzo krótkie stuknięcie Caps Lock, więc muśnięcie klawisza go nie włączy. Strona może zobaczyć zdarzenie, a dioda pozostaje zgaszona. Ufaj getModifierState, a nie liczbie zdarzeń.

Telefony nigdy nie zgłaszają włączonego Caps Lock

Klawiatury ekranowe mają własny caps lock (dwukrotne dotknięcie Shift). Nie wysyła on zdarzeń Caps Lock, a getModifierState('CapsLock') zostaje false. Zgłasza go tylko klawiatura sprzętowa.

Caps Lock w grach i skrótach

Nie używaj Caps Lock jako klawisza do przytrzymywania: na Macu nie dostaniesz keyup, dopóki jest wciśnięty. Niektórzy przypisują go też do Ctrl lub Esc i wtedy strona dostaje tamten klawisz. Safari na Macu pokazuje już w polach hasła własny symbol Caps Lock, więc twoje ostrzeżenie może się tam pojawić dwa razy.