JavaScript-Bibliothek SoSciTools

SoSci Survey bindet im Fragebogen automatisch eine JavaScript-Bibliothek SoSciTools ein. Diese kann in JavaScripts innerhalb des Fragebogens verwendet werden.

Folgende statische Methoden stehen durch SoSciTools zur Verfügung:

• SoSciTools.getForm() – Liefert das HTML-Formularelement <form> des Fragebogens.
• SoSciTools.disableInputs() – Deaktiviert alle Eingabe- und Auswahlfelder auf der aktuellen Fragebogen-Seite (z.B. um Fragen nochmals anzuzeigen ohne dass der Teilnehmer noch etwas ändert, s. auch answers())
• SoSciTools.disableInputs2() – Ersetzt alle Eingabe- und Auswahlfelder durch Grafiken oder Textelemente.

• SoSciTools.questionnaire – Instanz von SoSciTools.Questionnaire zu Steuerung der Fragebogen-Seite
• SoSciTools.progress – Instanz von SoSciTools.Progress zu Steuerung des Fortschrittsbalkens

• SoSciTools.submitPage() – Die Antworten der aktuellen Seite übermitteln, so als würde der Weiter-Knopf gedrückt.

• SoSciTools.submitButtonsHide() – Weiter- und Zurück-Knopf ausblenden
• SoSciTools.submitButtonsDisplay() – Weiter- und Zurück-Knopf einblenden
• SoSciTools.showButtons() – Anzeige von Weiter- und Zurück-Knopf bzw. weiteren Knöpfen (Sprachumschalter, Interview abbrechen, Interview unterbrechen) steuern
• SoSciTools.submitButtonEnable() – Den Weiter-Knopf aktiv oder inaktiv (disabled) schalten

• SoSciTools.attachEvent() – Weist einem oder mehreren JavaScript-Ereignissen (Events) eine Funktion zu (browserübergreifend)
• SoSciTools.attachEventToForm() – Weist jeglicher Änderung innerhalb der Fragebogen-Seite eine Funktion zu (browserübergreifend)
• SoSciTools.detachEvent() – Löst eine vorher zugewiesene Funktion von einem JavaScript-Ereignis (browserübergreifend)
• SoSciTools.dispatchEvent() – Löst ein JavaScript-Ereignis aus (browserübergreifend)
• SoSciTools.getSender() – Ermittelt das Ursprungsobjekt eines JavaScript-Ereignisses (browserübergreifend)
• SoSciTools.inArray() – Prüft, ob ein Element in einem Array enthalten ist (browserübergreifend)
• SoSciTools.recordTime() – zeichnet die Bearbeitungszeit in einer interne Variable auf.

Die Variable SoSciTools.questionnaire beherbergt ein Objekt der Klasse SoSciTools.Questionnaire. Das Objekt unterstützt folgende Methoden:

• attachCheck() – Registriert eine Funktion zur Prüfung der Eingabe. Die Funktion wird aufgerufen, wenn der Teilnehmer den Weiter-Knopf verwendet.
• submit() – Die Antworten der aktuellen Seite übermitteln, so als würde der Weiter-Knopf gedrückt.

Die Variable SoSciTools.progress enthält ein Objekt der Klasse SoSciTools.Progress und unterstützt die folgenden Methoden:

• addEventListener() – Registriert eine Funktion für die Ereignisse 'present' oder 'change'.
• set() – Ändert den angezeigten Prozentwert. Anders als die PHP-Funktion option('progress', ...) hat dies keinen Einfluss auf den Prozentwert, der auf der nachfolgenden Seite angezeigt wird.