<clear>

<clear>

The <clear> element resets one or more form items.

Attributes

Name

Description

namelist

The list of variables to be reset; this can include variable names other than form items. When not specified, all form items in the current form are cleared.

Notes

None

Example

<?xml version="1.0"?>
<vxml version="2.0">
<form>
<field name="myprompt" type="digits">
<prompt>
Say the magic number between 1 and 9.
</prompt>
<filled>
<if cond="myprompt==5">
<prompt>
You guessed correctly!
</prompt>
<elseif cond="myprompt==4 || myprompt==6"/>
<prompt>
You're close. Try again.
</prompt>
<!-- If we were not to clear the "myprompt" -->
<!-- variable, the dialog would simply -->
<!-- finish. Instead, we force another -->
<!-- attempt to fill the field. -->
<clear namelist="myprompt"/>
<else/>
<prompt>
Try again.
</prompt>
<clear namelist="myprompt"/>
</if>
</filled>
</field>
</form>
</vxml>

The output of the above script would be:

Computer: Say the magic number between one and nine. Human: Three. Computer: Try again. Say the magic number between one and nine. Human: Six. Computer: You're close. Try again. Say the magic number between one and nine. Human: Five. Computer: You guessed correctly!

Child Tags

None

Parent Tags

<block>, <catch>, <error>, <filled>, <foreach>, <help>, <if>, <noinput>, <nomatch>