CompositionEvent#
CompositionEvent.data#
Właściwość data zwraca łańcuch znakowy reprezentujący wygenerowane przez metodę wejściową znaki dla danego zdarzenia. Jeśli wygenerowane znaki nie zostały przekazane w czasie tworzenia zdarzenia, to zwracany będzie pusty łańcuch znakowy. 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 composition_data = compositionEvent.data;
gdzie poszczególne człony oznaczają:
composition_data- wygenerowane znaki w postaci łańcucha znakowego.compositionEvent- zdarzenie będące obiektem kontekstu.
Przy tworzeniu zdarzenia wartością domyślną dla właściwości data musi być pusty łańcuch znakowy.
W czasie wysyłania zaufanych zdarzeń wartość przechowywana we właściwości data będzie uzależniona od sposobu wygenerowanych znaków i samego zdarzenia kompozycji. Może być to pojedynczy znak Unicode lub niepusta sekwencja znaków Unicode (np. przy wprowadzaniu/wybieraniu całych ciągów). Znaki powinny być znormalizowane zgodnie z dokumentem "Unicode Normalization Forms". Dozwolony jest także pusty łańcuch znakowy (np. w czasie rozpoczynania sesji kompozycji).
W przypadku syntetycznych zdarzeń możemy samodzielnie ustawić wygenerowane przez metodę wejściową znaki dla zdarzenia, np. w czasie tworzenia lub inicjowania zdarzenia.
Prosty przykład:
<!DOCTYPE html>
<html>
<head>
<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.data: " + e.data + "<br><br>";
info.innerHTML = info.innerHTML + data;
}
input.addEventListener("compositionstart", readInfo, false);
input.addEventListener("compositionupdate", readInfo, false);
input.addEventListener("compositionend", readInfo, false);
}
</script>
</head>
<body>
<p>Ustaw zogniskowanie w poniższej kontrolce i wprowadź jakieś dane przy użyciu IME by uzyskać szczegółowe informacje dla zdarzeń.</p>
<input id="input" type="text" value="Dane tekstowe">
<p style="color: blue;">Szczegółowe informacje dla przechwyconego zdarzenia:</p>
<p id="info"></p>
</body>
</html>Interfejs Web IDL#
readonly attribute DOMString data;