Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła