<field>

A field specifies an input item to be gathered from the user.

Attributes
name The form item variable in the dialog scope that will hold the result. The name must be unique among form items in the form.
cond An expression that must evaluate to true after conversion to Boolean in order for the form item to be visited. The form item can also be visited if the attribute is not specified.
expr The initial value of the form item variable; default is ECMAScript undefined. If initialized to a value, then the form item will not be visited unless the form item variable is cleared.
type The type of field, i.e., the name of a built-in grammar type. See Section 2.4.
slot The name of the grammar slot used to populate the variable (if it is absent, it defaults to the variable name). This attribute is useful in the case where the grammar format being used has a mechanism for returning sets of slot/value pairs and the slot names differ from the form item variable names.
modal (defaults to false) If this is false, all active grammars are turned on while collecting this field. If this is true, then only the field's grammars are enabled: all others are temporarily disabled.


Child Tags
<audio>, <catch>, <enumerate>, <error>, <filled>, <grammar>, <help>, <link>, <noinput>, <nomatch>, <option>, <prompt>, <property>, <value>


Parent Tags
<form>


Notes
Four useable shadow variables are returned: name$.utterance, name$.interpretation, name$.inputmode, and name$.confidence.  The PlumVP platform includes support for the standard application variables, by default the platform will attempt to fetch the 5-best matches to an utterance.  The n-best results are available the application.lastresult$[i] variable. For more information about the standard application variables see Section 1.5.


Example
<?xml version="1.0"?>
<vxml version="2.0">
    <form>
        <!-- See section 2.3 for the list of available built-in grammars. -->
        <field name="myfield" type="digits?length=7">
            <prompt>
                Say or enter seven digits.
            </prompt>
            <filled>
                You entered <value expr="myfield"/>.
            </filled>
        </field>
   </form>
</vxml>

An interaction with the above script could be:

Computer: Say or enter seven digits.
Human: Five five five one two one two.
Computer: You entered five million five hundred fifty-one thousand two hundred twelve.