html.settings.inputWarning

getHtml(id).settings.inputWarning( message ) Defines the error message that gets displayed if an obligatory input field is not filled when calling . If you use %name% in the string it will be replaced with the element’s name. Example: [js highlight=”3″ try=”true”]newHtml(“intro”, “example_intro.html”) .settings.checkboxWarning(“It is highly recommended that you check the ‘%name%’ box before continuing”) .settings.inputWarning(“We would …

html.settings.checkboxWarning

getHtml(id).settings.checkboxWarning( message ) Defines the error message that gets displayed if an obligatory checkbox is not checked when calling . If you use %name% in the string it will be replaced with the element’s name. Example: [js highlight=”2″ try=”true”]newHtml(“intro”, “example_intro.html”) .settings.checkboxWarning(“It is highly recommended that you check the ‘%name%’ box before continuing”) .settings.radioWarning(“Please consider selecting …

controller.wait

getController(id).wait() (since PennController 1.7) or getController(id).wait( test ) (since PennController 1.7) Waits until the controller has been completed. Example: [js highlight=”9″ try=”true”]newButton(“Start reading”) .print() .wait() .remove() , newController(“DashedSentence”, {s: “The mouse that the cat that the dog is petting is hugging is happy”} ) .print() .log() .wait() .remove() , newText(“Good job!”) .print() [/js]

video.settings.disable

getVideo(id).settings.disable() or getVideo(id).settings.disable(opacity) (since PennController 1.6) Will disable the controls interface. Note that some browsers might make the controls disappear altogether. If you pass no parameter, a 50% opaque layer will be printed on top of the interface. You can pass a value from 0.01 (fully transparent***) to 1 (fully opaque) to control the aspect …

audio.settings.disable

getAudio(id).settings.disable() or getAudio(id).settings.disable(opacity) (since PennController 1.6) Will disable the controls interface. Note that some browsers might be render disabled interfaces as a plain gray rectangle with no controls visible whatsoever. If you pass no parameter, a 50% opaque layer will be printed on top of the interface. You can pass a value from 0.01 (fully …

scale.unselect

getScale(id).unselect() (since PennController 1.6) Will unselect the option currently selected. If the scale is a slider, it will set it back to the central value. Example: [js highlight=”5″ try=”true”]newScale(“score”, 10) .print() , newButton(“Unselect”) .settings.callback( getScale(“score”).unselect() ) .print()[/js] Prints a 10-point radio button scale and a button reading Unselect which, when clicked, unselects the currently selected …

dropdown.settings.once

getDropDown(id).settings.once() (since PennController 1.5) Will disable the DropDown element after selection occurs. Example: [js highlight=”2″ try=”true”]newText(“I saw Erika talk to Nate.”) .settings.after( newDropDown(“”).settings.add(“He”,”She”).settings.once() ) .settings.after( newText(“seemed anxious.”) ) .print()[/js] Prints I saw Erika talk to Nate. ___ seemed nervous onto the page, where ___ is a drop-down list containing the options He and She. The …

dropdown.settings.callback

getDropDown(id).settings.callback( command ) (since PennController 1.5) or getDropDown(id).settings.callback( command1, command2 ) (since PennController 1.5) Will execute the command(s) whenever an option is selected from the drop-down list. Example: [js highlight=”7-18″ try=”true”]newText(“The weather is”) .settings.after( newDropDown(“temp”,”…”).settings.add(“cold”,”warm”,”hot”) ) .settings.after( newText(“implicature”, “implies that the weather is …”) ) .print() , getDropDown(“temp”) .settings.callback( getDropDown(“temp”) .test.selected(“warm”).success( getText(“implicature”).settings.text(“implicates that the weather …

PennController.DebugOff

PennController.DebugOff() (since PennController 1.4) Tells your experiment to not run in Debug mode. This will close the popin window at the bottom-right corner of your experiment, no longer providing you with debugging tools and helpful feedback. You should only use this command when you are ready to collect data. Check the tutorial for a rapid …