<clear>

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

Attributes

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>