Template for dSurvey clients (press the ? for details)
HeaderMessage (fixed)
messages (fixed)
Button (fixed)
Timer (fixed)
Group box.
Content box
Module box
Literal box
Message box (fixed)
Short Alerts (fixed)
Participant Name Footer message.
Status messages (not for use by participant)

end of page...
top
Template for dSurvey: client page
Click for descriptions.
headerMessage headerButton headerTimer groupBox contentDiv modulesDiv modulesDiv null nameBox quickDescBox statusMessages alertBox messageBox
The `header message area` is a fixed location at the top of the screen.
Unless explicitily set, it will be cleared whenever a section & groups is displayed.

You can set the contents by including, in a `<call>`:
writeHeader('A message')
For example:
writeHeader('Curent group: ' $+ groupName)
will write the current `sectionName.groupName` to this header.
This is the default location for buttons. It is a fixed location (it does not move when you page up and down the screen).

Buttons timers are created by a`<button>` event.
For example, the following button will be created with the text `Push me!`, and when the button is pushed the text becomes `now wait a second ...`:

<button> <text > Push me! /<text > <message > now wait a second... <text > goto, submit, or other actions ... </button>
Note: to place the button in some other screen location, include an `<id ... >` in the `<button>` event.
This is the default location for countdown timers. It is a fixed location (it does not move when you page up and down the screen).

Countdown timers are created by a `<timer>` event.
For example, the following timer will countdown from 60 seconds:fs

<timer> <time value="60" /> goto, submit, or other actions ... </timer>
Note: to place the timer in some other screen location, include an `<id ... >` in the `<timer>` event.
This is the default location for a button to invoke dSurvey's message feature. It is a fixed location (it does not move when you page up and down the screen).

dSurvey's message utility allows pariticpants to send, and recieve, message to other participants (and to the administrator). Note that this is different from messages displayed in the `Message box` (which are built into the dSurvey instrument).

Clicking this button will cause a window to open up on the screen, containing options (such as read your messages and send a message).

`<messages>` is used to control whether or not this messaging feature is enabled, and allows you to set a variety of options. Often, `<messages>` is specified in the `<messages>` (specifed in the `<init>` section of the SPEC File).

Note: to place the messages-button in some other screen location, include an `<id ... >` in the `<messages>`.
This is where longer messages are written. It is a fixed location (it does not move when you page up and down the screen).

You can write content to the message box
The `writeMessage` function Syntax:
writeMessage(amess,aheader)
Where...

1. `amess`: the message you wish to display
2. `aheader`: optional, a header for this message. If you do not specify `aheader` a header of `Click here to close this message box` is used

This message box is meant for transient messages. When the participant clicks anywhere in the message box, the box will disappear.

The `<info>` XHTML extension Syntax:
<info title="descriptive title" infoName="moduleToDisplay"> text to click </info>
This will create a link. When clicked on, the text contained in the `module-to-display` module specified) will be displayed in the message box (of course, you should specify a different `module-to-display` for different `<info>`s).
This is where short alerts are written. It is a fixed location (it does not move when you page up and down the screen). You can write content to the message box
The `writeAlert` function Syntax:
writeAlert(amess,aheader) or writeAlert(amess,aheader,1,iduration)
Where...

1. `amess`: the text message to display
2. `aheader`: optional, a header for this message.
3. `iduration`: optional. The duration, in milliseconds, of this alert. After `iduration` milliseconds, the alert box will disappear.

This alert box is meant for transient messages. When the participant clicks anywhere in the alert box, the box will disappear.

The `<message>`
/ option of the `<submit>` event Syntax:
<submit .. > <messsage long="message for the alert box" /> submit options </submit>

When a `submit` event occurs, the message specified in `long` will be written to the alert box.
The contents of a `group` is displayed here.

You can set `style` and `class` attributes for the `group` (which basically means, for all contents on this page) by including `style` or `class` in the `<group>` definition.
For example:
<group name="myGroup1" style="border:1px solid blue; font-family:Times New Roman,Serif;" > group specifications, such as <content> and <events> </group>
will put a blue border around the page, and use a Times New Roman font.
The contents of a `<content>` is displayed here.
Reminder: there can be one or more `<content>` elements within a `<group>`

You can set `style` and `class` attributes for the `content` in the `<group>` definition.
For example:
<group name="my1" style="margin-left:5%;border:1px solid blue; font-family:Times New Roman" > <content style="border: 2px dashed green"> content specifications, such as <modules> and <literal> </content> </group>
will embed a box with a dashed green border, in a page with a solid blue border and a Times New Roman font.
The contents of a `<modules>` or a `<literal>` is displayed here.
Reminder: there can be one or more `<modules>` and/or `<literal>` elements within a `<content>`

You can set `style` and `class` attributes for `modules` and `literals` within a `<content>` definition.
For example:
<group name="myGroup1" style="border:1px solid blue; font-family:Times New Roman,Serif;" > <content style="border: 2px dashed green"> <modules style="font-size:120%" >myModPage1 </modules> <literal style="font-size:80%" > <p/>Goodbye. </literal > </content> </group>
Within a a box with a dashed green border, in a page with a solid blue border and a Times New Roman font, there the contents of the `myPage1` module will be displayed with a large font, and at the bottom of the page a Goodbye. will appear.
The name of the participant is written here. This does not change, and is always present.
Note: to suppress display of the contents of the footer (the `participant name`, `description`, and `status messages`), use the following in a `<call>`:
displayDiv('_footerBlock','none')
and to unhide the footer, use:
displayDiv('_footerBlock','block')
Status messages from dSurvey are written here. These are meant for use by the administrator.
By default, these are not visible. To see them, click on the `particpant name` box.
Note: to suppress display of the contents of the footer (the `participant name`, `description`, and `status messages`), use the following in a `<call>`:
displayDiv('_footerBlock','none')
and to unhide the footer, use:
displayDiv('_footerBlock','block')
A short footer message can be written here.

You can set this message using the `writeFooter` function within a `<call>`:
writeFooter('your short descriptive message ')
Note that messages written here are permanent -- they do not change when a new group or section is loaded. In contrast, messages written to the `header` are cleared whenever a new group or section is loaded.
Note: to suppress display of the contents of the footer (the `participant name`, `description`, and `status messages`), use the following in a `<call>`:
displayDiv('_footerBlock','none')
and to unhide the footer, use:
displayDiv('_footerBlock','block')