Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:questions:assignment [12.06.2018 20:52] – Events 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 168: / Zeile 175: @@
 </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() {
+    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.
+Das folgende Beispiel befasst sich mit folgender Präsentations-Abfolge:
+  - Anzeige eines Fixationskreuzes (750ms)
+  - Anzeige des Textes "ER" oder "SIE" (500ms)
+  - Anzeige einer Zahl zwischen 1 und 3 (500ms)
+  - Anzeige des Items -- mit Auswahloption "Ja" oder "Nein"
+In der Frage vom Typ "Zuordnungsaufgabe" (z.B. "ZA01") werden dafür eingestellt:
+  * Ein //Text vor dem ersten Stimulus//, z.B. "Zum Starten bitte klicken".
+  * Eine //Feste Höhe für Stimuli//, in diesem Fall 120 Pixel, damit die Anzeige zwischen Fixationskreuz und dem schmaleren Text nicht "springt".
+  * Im Karteireiter //Antwortkategorien// werden die Kategorien mit "Ja" und "Nein" beschriftet und
+  * das Häkchen bei //Auswahl einer Option mittels Tastatur erlaubt// wird entfernt, da die Teilnehmer nur Klicken sollen (optional).
+  * Im Karteireiter //Ablaufkontrolle// wird die //Pause zwischen den Stimuli// auf 1750ms gesetzt, damit Fixationskreuz (750ms) plus zwei Text-Primes (500ms) darin Platz finden.
+  * Die //Zeitbegrenzung pro Stimulus// kann festgelegt werden, falls erforderlich.
+Nach dem Speichern der Frage "ZA01" wird im Fragenkatalog noch ein Text "ZA02" angelegt (//Beschreibung// z.B. "JavaScript zu ZA01"). Als //Darstellung// wird hier "HTML-Code" gewählt. Der folgende Inhalt sorgt nun dafür, dass die Pause mit dem Fixationskreuz durch die o.g. Abfolge ersetzt wird. Das Ersetzen erfolgt durch Setzen von ''pause.innerHTML''.
+<code javascript>
+<script type="text/javascript">
+<!--
+function AssignmentPlus(qstID, contents) {
+  // Zunächst benötigen wir das HTML-Element, welches das Fixationskreuz zeigt
+  var outer = document.getElementById(qstID + "_pause");
+  var pause = outer.getElementsByTagName("td").item(0);
+  // Eine Mindest-Höhe wäre hilfreich, damit die Knöpfe nicht "springen"
+  pause.style.height = "120px";
+  function showContent(evt) {
+    // Ermitteln, welches Item gleich gezeigt wird
+    var item = evt.detail.item;
+    // Entsprechenden Teil aus der Liste verwenden
+    var show = contents["i" + item];
+    // Anzeigen der Inhalte nach Zeitplan
+    // Zunächst (direkt) ein Fixationskreuz (750ms)
+    pause.innerHTML = '<img src="../images/fixation.default.png" alt="+">';
+    // Nach 750ms dann der erste Teil des Inhalts (für 500ms)
+    window.setTimeout(function() {
+      pause.innerHTML =  show[0];
+    }, 750);
+    // Nach weiteren 500ms (insg. also nach 1250ms) der zweite Teil des Inhalts (für 500ms)
+    window.setTimeout(function() {
+      pause.innerHTML =  show[1];
+    }, 1250);
+    // Weiter zum Item geht es dann nach 1250+500 = 1750ms
+    // Das ist die Gesamtdauer für die Fixation (in der Frage einzustellen)
+  }
+  // Aufruf der Methode bei jeder Fixations-Pause
+  %qst%_qst.addEventListener("fixation", showContent);
+}
+// Initialisieren der AssignmentPlus Instanz
+SoSciTools.attachEvent(window, "load", function() {
+    // Inhalte, welche bei den einzelnen Items gezeigt werden sollen
+    // (auch hier können Platzhalter zum Einsatz kommen)
+    new AssignmentPlus("%qst%", {
+      i1 : ["ER", "2"],
+      i2 : ["ER", "1"],
+      i3 : ["SIE", "3"],
+    });
+});
+// -->
+</script>
+</code>
+Am Ende des JavaScript-Codes ist ein Array definiert, welche Inhalte bei den einzelnen Items angezeigt werden sollen. Hier sind exemplarisch nur die Inhalte für 3 Items angegeben. Nach Bedarf kann hier natürlich auch mit Platzhaltern gearbeitet werden, z.B. wenn eine Randomisierung oder Rotation erforderlich ist.
+Zuletzt ist noch ein klein wenig PHP-Code erforderlich, um den Platzhalter ''%qst%'' mit der Kennung der Zuordnungsaufgabe ("ZA01") zu belegen. Hierfür sind unterschiedliche Varianten möglich -- der folgende PHP-Code bindet beide Elemente (die Frage und den HTML-/JavaScript-Code) ein und belegt den Platzhalter:
+<code php>
+show('ZA01');
+show('ZA02', array(
+  '%qst%' => 'ZA01'
+));
+</code>
+Der PHP-Code steht alleine auf einer Fragebogen-Seite. Die beiden Elemente dürfen nicht (!) zusätzlich dazu in die Seite gezogen werden.