CKTIS / HTML
onkeydown — obsługa naciśnięcia klawisza
Atrybut onkeydown zawiera kod JavaScript obsługujący zdarzenie keydown. Pozwala reagować na naciśnięcie klawisza; obiekt event udostępnia dane zdarzenia. Nie jest to atrybut logiczny.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onkeydown="JavaScript statements"onkeydown to atrybut obsługi zdarzenia keydown w HTML. Jego wartość jest treścią funkcji JavaScript, a nie nazwą zdarzenia ani adresem URL. Samo umieszczenie nazwy funkcji bez jej wywołania nie uruchamia tej funkcji.
W kodzie atrybutu parametr event udostępnia zdarzenie. Atrybut HTML onkeydown="…" i właściwość JavaScript element.onkeydown konfigurują ten sam mechanizm obsługi; przypisanie nowej funkcji do właściwości zastępuje dotychczasową obsługę.
return false anuluje domyślną akcję zdarzenia, jeśli zdarzenie można anulować, ale nie zatrzymuje jego propagacji. Polityka Content Security Policy może blokować obsługę wpisaną bezpośrednio w atrybut. Nigdy nie wstawiaj do niego niezaufanego tekstu jako kodu.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onkeydown example</title>
<button type="button" onkeydown="if (event.key === 'Enter') document.getElementById('result').textContent = 'Enter';">Focus here; press Enter</button>
<p id="result" aria-live="polite">Waiting</p>
</html>Wynik
Enter
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.