Timer

The timer field executes its handler when the timer starts, stops, or after a set period. The timer countdown can be set to start on page load or triggered by another event using the startTimer() custom function. The execution can occur once or on repeat.

Field Values and the Handler

Like any field, the timer's handler is triggered when the field's value changes. The timer has three possible values, timerStart (set when the timer starts), timerTrigger (set when the interval is reached if the timer is on repeat) and timerStop (set when the timer is reached or stops repeating). When writing your handlers you can specify what the timer does at each of these points. If you don't, the handler will be triggered at each stage (ie when the timer starts, when the timer is triggered, and when the timer stops).

Custom Functions

Custom functions can be called from the handlers of other fields using .invokeCustomFieldFn.

startTimer() - starts the timer
stopTimer() - stops the timer
changeRepeat(newrepeat) - a boolean to toggle the repeat property between true and false
changeInterval(newInterval) - an integer value to change the interval to

Properties

Label	Description	Type Name
Interval (milliseconds)	The number of milliseconds until the handler function is called	INTERVAL
On Load	Either true or false for whether or not the timer should start counting down on page load	ONLOAD
Repeat	If true the timer will repeat using the set interval. If false the timer will only fire once	REPEAT
Handler	The JavaScript function that will be executed when the timer reaches zero or the field value changes	HANDLERS
Documentation	Add documentation to your field to help explain any complex functionality to future users. You might include information on what the field does and how it relates to other fields on the form. Notes added here are only ever visible in the Forms Designer, they can be searched for, viewed and downloaded from the action panel. See Common Field Properties for an example	DOCUMENTATION