VoiceXML Tag <choice> Version 2.0

GetVocal Voice Portal Technologies

[1.0 to 2.0][Tags][Attributes][Variables][Events][Properties]

VoiceXML Tag
<choice>

Defines a menu option.

Parent Tags
<menu>

Content Syntax
The value may be empty, or may contain one or more elements, where an element is either parsed text or one of the following tags.

<audio> <break> <emphasis> <enumerate> <grammar> <mark> <p> <paragraph> <phoneme> <prosody> <s> <say-as> <sentence> <value> <voice>

Attributes

Name	Req/opt	Default	Valid values
accept	Optional	"exact"	"approximate" "exact"
caching	Optional		"fast" "safe"
dtmf	Optional		Text
event	Optional		Text
expr	Optional		Text
fetchaudio	Optional		Text
fetchhint	Optional		"prefetch" "safe" "stream"
fetchtimeout	Optional		Text
next	Optional		Text

Compatibility
VoiceXML 1.0 Yes, 2.0 Yes.

Description
Specifies one choice in a <menu>.

When the choice is selected by the user by making appropriate input, the choice tag will either transition to a new dialog or throw an event. To indicate the action to take, exactly one of the next, expr or event attribute must be set. The next and expr attributes specify the URL of the next dialog.

A choice may contain a prompt to be spoken to explain the choice to the user. This prompt is available through the special _prompt variable in the <enumerate> tag.

The choice may contain one or more grammars which specify the user input which selects it. Alternatively, the dtmf attribute can be set to indicate a touch-tone digit which selects it. If the parent <menu> tag has dtmf="true", then a digit will be assigned automatically to this choice if one is not specified. The digit assigned to the choice is available through the special _dtmf variable in the <enumerate> tag.