Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:questions:suggest [29.01.2015 16:56] – Aktualisierung admin
+++ de:create:questions:suggest [13.01.2022 21:41] (aktuell) – [JavaScript-Anbindung] admin
@@ Zeile 11: / Zeile 11: @@
 ===== Vor- und Nachteile =====
-Die Texteingabe mit Auswahlempfehlung ist vor allem dann hilfreich, wenn es in einer Frage sehr viele Antwortmöglichkeiten gibt -- und andere Fragetypen wie Dropdown oder sichtbare Auswahl ([[select|Auswahlfragen]]) deshalb zu unübersichtlich sind. Weiterhin ist die Auswahlempfehlung intuitiver, wenn neben den vorgegeben Auswahloptionen auch offene Antworten möglich sind.
+Die Texteingabe mit Auswahlempfehlung ist vor allem dann hilfreich, wenn es in einer Frage sehr viele Antwortmöglichkeiten gibt -- und andere Fragetypen wie Dropdown oder sichtbare Auswahl deshalb zu unübersichtlich sind. Weiterhin ist die Auswahlempfehlung intuitiver, wenn neben den vorgegeben Auswahloptionen auch offene Antworten möglich sind.
 Allerdings ist zum Antworten zwingend ein Wechsel von Maus- zu Tastaturbedienung erforderlich -- gerade auf Mobilgeräten ([[:de:create:smartphones|Fragebögen für Mobilgeräte]]) ist eine Dropdown-Auswahl u.U. einfacher zu beantworten.
@@ 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.