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:

  1. L
  2. K
  3. T'
  4. T
  5. A
  6. O
  7. Z'
  8. Z
  9. #
var composition_data = compositionEvent.data;

gdzie poszczególne człony oznaczają:

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:

  1. L
  2. K
  3. T'
  4. T
  5. A
  6. O
  7. Z'
  8. Z
  9. #
<!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#

  1. L
  2. K
  3. T'
  4. T
  5. A
  6. O
  7. Z'
  8. Z
  9. #
readonly attribute DOMString data;

Specyfikacje i inne materiały#

Pasek społecznościowy

SPIS TREŚCI AKTUALNEJ STRONY

CompositionEvent (H1) CompositionEvent.data (H2) Składnia (H3) Interfejs Web IDL (H3) Specyfikacje i inne materiały (H3)