Questionnaire - Javascript Fun Tips

Basic Hints

Questionnaire viewer is implemented in a way that you can add javascript to manipulate the way your questions are displayed.

jQuery is already included in the viewer, thanks to what javascript has even more powerful effect! (read more about jquery here: http://jquery.com/)

Javascript is a property on both question and questionnaire levels, which means that you can add javascript for each question or for the whole questionnaire.

The most important features are:

quest: the current question's object
questioncheck: the function called before going Next

quest

There are several important properties in quest object:

quest.questions: array of sub questions
quest.options: array of answer options
quest.setQuestions(Array subQuestions): assign an array of question objects to the sub question list of the current question
quest.setOptions(Array options): assign an array of options to the answer option list of the current question
quest.setAnswer(string value): assign a value to the question
ques.getHTML(): returns the HTML which will be rendered to display the question
quest.onInit(): called right after loading the question
quest.rotateAnswerOptions(startIndex, endIndex, rotateIndex): rotate answer options in a range specified by startIndex and endIndex, the first item in the range will be rotateIndex
quest.rotateSubQuestions(startIndex, endIndex, rotateIndex): rotate sub questions in a range specified by startIndex and endIndex, the first item in the range will be rotateIndex
quest.randomizeAnswerOptions(randomSeed, startIndex, endIndex): randomize answer options in a range specified by startIndex and endIndex, the order is unique for each randomSeed
quest.randomizeSubQuestions(randomSeed, startIndex, endIndex):randomize sub questions in a range specified by startIndex and endIndex, the order is unique for each randomSeed

questioncheck()

We need to override this function to get rid of the default question check supported by the questionnaire viewer, it is a must when showing more than one questions in the same page. The function returns true when there is nothing wrong and false otherwise.

There is an object which should be used to display errors: ErrorMessages.

ErrorMessages.getInstance().clearErrorMessages(): clear all existing error messages
ErrorMessages.getInstance().showErrorMessage(msg): show an error message