Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:questions:assignment [25.02.2019 09:38] – admin
+++ de:create:questions:assignment [28.05.2021 21:47] – admin
@@ Zeile 92: / Zeile 92: @@
 Die JavaScript-Funktion ''setCallbackSelect()'' (siehe oben) ist primär für die Filterführung ausgelegt. Daneben unterstützt die Zuordnungsaufgabe noch Ereignisse (Events), mit denen JavaScript direkt eingreifen kann. Die folgenden Ereignisse werden vom Container der Frage ausgelöst:
-  * ''fixation'' -- Zwischen zwei Stimuli (Items) wird eine Pause gesetzt, welche z.B. ein Fixationskreuz anzeigt. Dieses Ereignis wird nur ausgelöst, wenn zwischen den Stimuli eine Pause eingestellt wurde. In der ''detail''-Eigenschaft des Ereignis stehen folgende Attribute zur Verfügung:
+  * ''fixation'' -- Zwischen zwei Stimuli (Items) wird eine Pause gesetzt, welche z.B. ein Fixationskreuz anzeigt. Dieses Ereignis wird nur ausgelöst, wenn zwischen den Stimuli eine Pause eingestellt wurde. In der ''detail''-Eigenschaft des Ereignises stehen folgende Attribute zur Verfügung:
     * ''evt.detail.question'' -- Kennung der Frage
     * ''evt.detail.item'' -- Kennung (ID) des Items, welches nach der Pause angezeigt wird
@@ Zeile 111: / Zeile 111: @@
     * ''evt.detail.item'' -- Kennung (ID) des Stimulus
     * ''evt.detail.option'' -- Die ausgewählte Kategorie (beginnend mit 1)
+Mit der Funktion ''setPrimeTimes()'' kann die Darbietungsdauer für Primes (sofern diese für Stimuli/Items definiert wurden) individuell festgelegt werden.
 ==== Beispiel: Audio abspielen ====
@@ Zeile 166: / Zeile 169: @@
 });
 // -->
+</script>
+</code>
+==== Zeiten für Primes variieren ====
+Das folgende JavaScript verändert die Darbietungsdauer für die Primes, welche in den Items 1, 2 und 3 definiert wurden. Die Zahl hinter der Item-Nummer gibt dabei die Anzeigedauer in Millisekunden (ms) an.
+<code html>
+<script type="text/javascript">
+window.addEventListener("load", function() {
+    SoSciTools.questionnaire.AB01.setPrimeTimes({
+: 2000,
+: 500,
+: 1000
+    });
+});
+</script>
+</code>
+Falls die Anzeigezeiten für die Primes dynamisch variiiert werden sollen, kann die Liste der Prime-Anzeigedauern auch im PHP-Code erstellt und anschließend mittels Platzhalter in den JavaScript-Code übernommen werden. Der JavaScript-Code würde dabei als Text (Darstellung: "HTML-Code") mit Platzhalter (''%primeTimes%'') im Fragenkatalog abgelegt.
+<code html>
+<script type="text/javascript">
+window.addEventListener("load", function() {
+    SoSciTools.questionnaire.%question%.setPrimeTimes(%randomTimes%);
+});
+</script>
+</code>
+Der PHP-Code könnte dann wie folgt aussehen. Er würde die zufällig gewählten Zeiten in den internen Variablen der Frage "AB03" speichern.
+<code php>
+$times = [];
+for ($i=1; $i<=20; $i++) {
+  $randomTime = random(100, 1000);
+  put(id('AB03', $i), $randomTime);
+  $times[$i] = $randomTime;
+}
+// Textbaustein AB02 einbinden und dabei
+// die Platzhalter für Frage-Kennung und die Zeiten einsetzen
+show('AB02', [
+    '%question%' => 'AB01',
+    '%randomTimes%' => json_encode($times)
+]);
+</code>
+==== Zeitbegrenzung variieren ====
+In der Zuordnungsaufgabe kann eine //Zeitbegrenzung pro Stimulus// definiert werden. Wenn die Befragte innerhalb dieses Zeitraums keine Antwort wählt, wird das Item übersprungen. Diese zeitliche Begrenzung gilt zunächst für alle Items der Frage.
+Mit der JavaScript-Methode ''setTimeouts()'' kann die Zeitbegrenzung für jedes Item individuell angepasst werden. Die Syntax entspricht jener von ''setPrimeTimes()''.
+Das folgende JavaScript legt für das dritte Item in der Zuordnungsaufgabe "AB01" eine Zeitbegrezung von 1200 Millisekunden (ms) fest und für das fünfte Item eine Zeitbegrezung von 2000 ms.
+<code html>
+<script type="text/javascript">
+window.addEventListener("load", function() {
+    SoSciTools.questionnaire.AB01.setTimeouts({
+: 1200,
+: 2000
+    });
+});
 </script>
 </code>