KeyboardEvent#
KeyboardEvent.code#
Właściwość code zwraca łańcuch znakowy reprezentujący wciśnięty klawisz (bez uwzględniania zmian klawiaturowych), który spowodował wysłanie danego zdarzenia. Właściwość jest tylko do odczytu.
Składnia#
Samo wywołanie i poszczególne jego części najlepiej objaśnić na zapisie składniowym:
var code_key = keyboardEvent.code;
gdzie poszczególne człony oznaczają:
code_key- łańcuch znakowy reprezentujący wciśnięty klawisz (bez modyfikacji).keyboardEvent- zdarzenie będące obiektem kontekstu.
Przy tworzeniu zdarzenia wartością domyślną dla właściwości code musi być pusty łańcuch znakowy.
Właściwość code przechowuje łańcuch znakowy identyfikujący fizyczny klawisz. Łańcuch ten nie zależy od aktualnego układy klawiatury lub stanu modyfikatora, zatem poszczególne klawisze za każdym razem zwrócą tę samą wartość. Dopuszczalne wartości kodów umieszczono w kilku tabelach z kodami dla zdarzeń klawiatury.
W przypadku syntetycznych zdarzeń możemy samodzielnie ustawić wartość klawisza (bez modyfikacji) dla zdarzenia, np. w czasie tworzenia zdarzenia.
Wartość klawisza po uwzględnieniu modyfikacji można odczytać przy użyciu właściwości KeyboardEvent.key.
Prosty przykład:
<!DOCTYPE html>
<html>
<head>
<style>
input:focus {outline: 5px solid green;}
</style>
<script>
// Uruchom po całkowitym załadowaniu dokumentu
window.onload = function(){
var input = document.getElementById("input");
var info = document.getElementById("info");
function readInfo(e){
var data = "Interfejs: " + e
+ "<br>" + "e.type: " + e.type
+ "<br>" + "e.code: " + e.code
+ "<br>" + "e.key: " + e.key + "<br><br>";
info.innerHTML = info.innerHTML + data;
}
input.addEventListener("keydown", readInfo, false);
input.addEventListener("keyup", readInfo, false);
}
</script>
</head>
<body>
<p>Ustaw zogniskowanie w poniższej kontrolce i wciśnij dowolny klawisz (z opcjonalnym modyfikatorem) by uzyskać szczegółowe informacje dla zdarzenia.</p>
<input id="input" type="text" value="Wybierz mnie">
<p style="color: blue;">Szczegółowe informacje dla przechwyconego zdarzenia:</p>
<p id="info"></p>
</body>
</html>Na chwilę obecną żadna aktualna przeglądarka internetowa nie obsługuje właściwości code.
Interfejs Web IDL#
readonly attribute DOMString code;