Show pageOld revisionsBacklinksExport to PDFBack to top This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong. ====== < choice > ====== ===== Description ===== The <choice> element defines a menu item and serves several purposes: * Specifies a speech grammar fragment and/or a DTMF grammar fragment that determines when that choice has been selected. * Forms the <enumerate> prompt string with its contents. * Specifies the URI to go to when the choice is selected. ===== Syntax ===== <code> <choice dtmf="DTMF sequence" accept="exact" | "approximate" next="URI" event="event" expr="ECMAScript_Expression" fetchaudio="URI" fetchhint="prefetch" | "safe" fetchtimeout="time_interval" maxage="time_interval" maxstale="time_interval"> child elements </choice> </code> ===== Attributes ===== |dtmf|This attribute is the DTMF sequence for this choice. This attribute is optional.| |accept|The accept attribute overrides the setting for the accepted attribute in the <menu> element, with either exact or approximate values. This attribute is optional and defaults to exact. * exact – use exact to define the exact phrase to be recognized. * approximate – use approximate to define an approximate recognition phrase. A subset of the words in the phrase expression can be matched. For example, "Hello world" can be matched with "Hello world", "Hello", or "World".| |next|The next attribute is the URI of the next dialog or document.| |event|This attribute throws a specified event. Next and expr attributes have precedence over this attribute.| |expr|The expr attribute is an ECMAScript Expression that defines the URI to transition. The next attribute has precedence over this attribute.| |fetchaudio|The fetchaudio attribute is the URI of the audio to play while waiting for the next document to be fetched.| |fetchtimeout|This attribute indicates the time interval to wait for an audio file to be fetched before playing the alternate content. This attribute is optional.| |fetchhint|The fetchhint attribute defines when the audio file should be retrieved. This attribute is optional. * prefetch - the file can be fetched when the document is loaded. * safe - the file is fetched only when needed.| |maxage|This attribute indicates the maximum time in seconds that this document will use this file before fetching another copy. This attribute is optional.| |maxstale|The maxstale attribute indicates the maximum time in seconds that this document will use the file that exceeded the maxage time. This attribute is optional.| ===== Parents ===== <code> <menu> </code> ===== Children ===== <code> <audio>, <enumerate>, <grammar>, <value> </code> ===== Extensions ===== <code> None. </code> ===== Limitations/Restrictions ===== <code> The dtmf attribute must be specified. </code> ===== Example Code ===== <code> <?xml version="1.0"?> <vxml version="2.0" xmlns="http://www.w3.org/2001/vxml"> <menu> <prompt> What do you want for drink, coffee or tea? </prompt> <choice dtmf="1" next="#getcoffee"> coffee </choice> <choice dtmf="2" next="#gettea"> tea </choice> <noinput> Please say coffee or tea </noinput> <nomatch> Please say coffee or tea </nomatch> </menu> <form id="getcoffee"> <block> <prompt>Ok, here's your coffee</prompt> </block> </form> <form id="gettea"> <block> <prompt>Ok, here's your tea</prompt> </block> </form> </vxml> </code> developer_guide/voicexml_references/elements/choice.txt Last modified: 2015/10/13 21:42by borja