<filled>

Specifies actions that may be executed when a given input field item or combination of input field items is filled.

The <filled> element may occur as a child of the <form> element, or as a child of an input item. When used within a single input field, it performs an action when that field has been filled; when used within a <form>, it is used to perform an action when a combination of one or more items has been filled.

Attributes

This section describes the attributes you can set for this element.

Name

Data type

Default

mode

(any | all)

all

namelist

NMTOKENS

optional

mode

You can set the mode attribute to either any or all (default). Setting the mode attribute to any causes the <filled> element to be processed when any of the field items listed in the namelist attribute are filled. Setting the mode attribute to all causes the <filled> element to be processed when all field items specified by the namelist attribute are filled.

namelist

The namelist attribute specifies the field items that must be filled before a <filled> element can be processed. If a <filled> element is contained within a form, the namelist attribute defaults to the names (explicit and implicit) of the form's field items.

Note: A <filled> element contained within a field item cannot specify a namelist and applies only to the enclosing field item.

Children (optional)

Parents

Sample code

<vxml>
    <form>
        <field name="grammar_or_dtmf">
            <prompt>Press or say a number between 1 
            and 3.</prompt>
            <grammar> [one two three] </grammar>
            <dtmf> [dtmf-1 dtmf-2 dtmf-3] </dtmf>
            <filled>
                <if cond="grammar_or_dtmf == 'one'">
                    <prompt>you said one</prompt>
                <elseif cond="grammar_or_dtmf == 'two'"/>
                    <prompt>you said two</prompt>
                <elseif cond="grammar_or_dtmf == 'three'"/>
                    <prompt>you said three</prompt>
                <else/>
                    <prompt>you pressed <value expr=
                    "grammar_or_dtmf.charAt(5)"/></prompt>
                </if>
            </filled>
        </field>
    </form>
</vxml>