Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:questions:assignment [25.02.2019 09:38] – admin
+++ de:create:questions:assignment [27.07.2022 14:35] (aktuell) – 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 112: / Zeile 112: @@
     * ''evt.detail.option'' -- Die ausgewählte Kategorie (beginnend mit 1)
-==== Beispiel: Audio abspielen ====
+Mit der Funktion ''setPrimeTimes()'' kann die Darbietungsdauer für Primes (sofern diese für Stimuli/Items definiert wurden) individuell festgelegt werden.
+Mit der Funktion ''setPauseTimes()'' kann die Dauer der Pause zwischen den Items individuell festgelegt werden, in welcher ggf. die Fixation angezeigt wird.
+Die Funktion ''selectOption()'' löst dieselbe Reaktion aus wie der Klick auf eine Antwortoption. In Klammern wird die Nummer der Option (beginnend mit 1) eingetragen.
+==== Audio abspielen ====
 Falls die Stimuli (auch) eine Audio-Datei enthalten, kann diese über das ''present''-Ereignis zum richtigen Zeitpunkt abgespielt werden. Stimuli 1 und 2 hätte beispielsweise folgenden Inhalt:
@@ Zeile 170: / Zeile 177: @@
-===== Mehrere Inhalte zeitgesteuert präsentieren =====
+==== 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() {
+    s2.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() {
+    s2.%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 Zeitbegrenzung von 1200 Millisekunden (ms) fest und für das fünfte Item eine Zeitbegrenzung von 2000 ms.
+<code html>
+<script type="text/javascript">
+window.addEventListener("load", function() {
+    s2.AB01.setTimeouts({
+: 1200,
+: 2000
+    });
+});
+</script>
+</code>
+===== Automatischer Start =====
+Es gibt Situationen, in welchen der der Wechsel vom Einführungstext zum ersten Stimulus zeitgesteuert erfolgen soll. Der folgende JavaScript-Code löst diesen Wechsel 2 Sekunden nach dem vollständigen Laden der Seite aus. Die Kennugn "AB01" muss gegen die Kennung der Zuordnungsaufgabe getauscht werden.
+<code javascript>
+window.addEventListener("load", function() {
+  window.setTimeout(function() {
+    s2.AB01.selectOption(1);
+  }, 1000);
+});
+</code>
+===== Mehrstufiges Priming =====
 Standardmäßig kann die Zuordnungaufgabe for dem eigentlichen Stimulus (Items) ein Fixationskreuz (bei allen Items gleich, einzustellen in der Frage) und einen Prime (einzustellen im jeweiligen Item) anzeigen. Für manche Designs ist dies jedoch unzureichend. Mit ein wenig JavaScript lassen sich auch mehrere Inhalte vor dem eigentlichen Stimulus darstellen. Dafür wird der Zeitslot genutzt, der eigentlich dem Fixationskreuz vorbehalten ist.