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 [13.01.2022 21:41] (aktuell) – [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(string Text)'' können zusätzliche Antwortvorgaben definiert werden, die im Datensatz wie eine offene Texteingabe behandelt werden. Dies ermöglicht die dynamische Anpassung der Antwortoptionen während des Ausfüllens. Die Methode ''clearExtraOptions()'' entfernt alle vorher ergänzten Optionen.
+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.