====== < form > ======

===== Description =====

Forms are key components in VoiceXML applications.  Forms collect user input and present information to the user. A form can define a field item (for collecting user input), or a control item (contains procedural items to help collect inputs).

===== Syntax =====

<code>
<form
id="String"
scope="dialog" | "document"
cleardtmf="true" | "false">
child elements
</form>
</code>

===== Attributes =====

|id|The id attribute defines the name of the form.  If specified, it can be referenced within the same document or from another document. e.g. <form id="hello"> can be referenced as <goto next="#hello"/>.   This attribute is optional.|
|scope|The scope attribute defines the scope of the form’s grammar. This attribute is optional and defaults to dialog. dialog – the form’s grammars are only active within the form. document – the form’s grammars are active throughout the document.  If this is an application root document, then the form grammars are active throughout the application.|

===== Parents =====

<code>
<vxml>
</code>

===== Children =====

<code>
<block>, <catch>, <error>, <field>, <filled>, <grammar>, <help>, <initial>, <link>, <noinput>, <nomatch>, <object>, <property>, <record>, <script>, <subdialog>, <transfer>, <var>
</code>

===== Extensions =====

<code>
None.
</code>

===== Limitations/Restrictions =====

<code>
None.
</code>

===== Example Code =====

<code>
<?xml version="1.0"?>
<vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">
 <form id="first">
  <block>
   <prompt>Hi, this is the first form</prompt>
   <goto next="#second"/>
  </block>
 </form>
 <form id="second">
  <block>
   <prompt>Thank you for coming to the second form</prompt>
  </block>
 </form>
</vxml>
</code>