developer_guide:voicexml_references:elements:menu

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

developer_guide:voicexml_references:elements:menu [2015/10/27 21:37] (current)
borja created
Line 1: Line 1:
 +====== < 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>
  • developer_guide/voicexml_references/elements/menu.txt
  • Last modified: 2015/10/27 21:37
  • by borja