====== < menu > ======

===== Description =====

The < menu > element presents a menu of choices to the user and transitions to another dialog based on user input.

===== Syntax =====

<code>
<menu
id="String"
scope="dialog" | "document"
dtmf="true" | "false"
accept="exact" | "approximate">
child elements
</menu>
</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.  For example, <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’s grammars are active throughout the application.|
|dtmf|The dtmf attribute enables DTMF input for all menu choices.  This attribute is optional and defaults to false. \\ * true – the interpreter assigns a DTMF sequence "1", "2", "3"... to the choices in order for all menu choices that do not explicitly define a DTMF sequence. \\ * false – the interpreter does not implicitly assign DTMF sequences.|
|accept|The accept attribute specifies the default grammar for each <choice> element.  This attribute is optional and defaults to exact. \\ * exact – the text of the <choice> element that defines the exact phrase to be recognized. \\ * approximate – the text of the <choice> element that defines an approximate recognition.|
|phrase|The phrase attribute is a subset of the words in the phrase expression that can be matched.  For example, "Hello world" can be matched with "Hello world", "Hello", or "World".|

===== Parents =====

<code>
<vxml>
</code>

===== Children =====

<code>
<audio>, <catch>, <enumerate>, <error>, <help>, <noinput>, <nomatch>, <prompt>, <property>, <record>, <value>
</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">
 <menu dtmf="true">
  <prompt>
   What information do you want?
   <enumerate>
    For <value expr="_prompt"/>, press <value expr="_dtmf"/>
   </enumerate>
  </prompt>
  <choice dtmf="1" next="#exit"> goodbye </choice>
  <choice dtmf="2" next="sports.vxml"> sports </choice>
  <choice dtmf="3" next="weather.vxml"> weather </choice>
  <choice dtmf="4" next="stock.vxml"> stock </choice>
 </menu>
 <form id="exit">
  <block>
   Good bye.
   <disconnect/>
  </block>
 </form>
</vxml></code>