Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:questions:suggest [29.01.2015 16:56] – [Vor- und Nachteile] admin
+++ de:create:questions:suggest [12.01.2022 22:17] – [JavaScript-Anbindung] admin
@@ Zeile 36: / Zeile 36: @@
 Erding; 85435
 </code>
+===== JavaScript-Anbindung =====
+Für jede Texteingabe mit Auswahlempfehlung wird ein JavaScript-Objekt der Klasse ''SoSciSuggest'' erstellt. Das Objekt ist über ''s2'' erreichbar. Der Name setzt sich aus der Kennung der Frage, einem ''e'' und der zweistelligen Nummer des Eingabefelds zusammen.
+  * Eine Frage mit der Kennung "TA01" und einem Eingabefeld würde also im JavaScript-Objekt ''s2.TA01a01'' abgebildet.
+  * Eine Frage mit der Kennung "TS02" und zwei Eingabefeldern würde das erste Eingabefeld im Objekt ''s2.TS02e01'' abbilden.
+Das Objekt besitzt eine Eigenschaft ''value'', welche den (Text-)Inhalt des Eingabefelds zurückliefert.
+Darüber hinaus unterstützt das Objekt die Methode ''addEventListener(String //EventID//, Function //Funktion//)'', welches bei Auswahl einer Option (//EventID// ''"change"'') oder bei Tastendrücken im Textfeld (//EventID// ''"keydown"'', ''"keypress"'', ''"keyup"'') die angegebene //Funktion// aufruft.
+Bitte beachten Sie, dass das JavaScript-Objekt erst am Ende der Seite erstellt wird, Event Handler können also erst nach dem Laden der Seite registriert werden:
+<code javascript>
+<script type="text/javascript">
+<!--
+window.addEventListener("load", function() {
+  suggestTA01.addEventListener("change", toogleFilter);
+  suggestTA01.addEventListener("keyup", toogleFilter);
+});
+// -->
+</script>
+</code>
+Mit der Methode ''addExtraOption()'' kann eine zusätzliche Antwortvorgabe definiert werden, die im Datensatz wie eine offene Texteingabe behandelt wird. Dies ermöglicht die dynamische Anpassung der Antwortoptionen während des Ausfüllens.
+Für gewöhnlich speichert die Auswahlempfehlung beim Ausfüllen der Fragebogen-Seite intern, welche Optionen für einen Suchbegriff vom Server übermittelt wurden. Mit der Methode ''clearCache()'' kann dieser Cache geleert werden -- das ist hilfreich, wenn während des Ausfüllens der Seite neue Antwortoptionen in die **Datenbank für Inhalte** aufgenommen wurden.