# <filled>

Description

Specifies an action to perform when some combination of input items are filled by user input. After the user's input is gathered and the relevant input items are set, the interpreter looks at each `<filled>` element in document order. Those whose conditions are matched by the utterance are then executed in order.

Syntax

    <filled
        mode="all" | "any"
        namelist="item1 item2 ...">
      child elements
    </filled>

Attributes

Attribute | Description
mode | The filled mode. Optional. (Default is all.) all - The `<filled>` element is executed when all of the input items in the `namelist` attribute are filled, and at least one has been filled by the last user input. any - The `<filled>` element is executed when any of the specified input items is filled by the last user input. This attribute cannot be defined when `<filled>` is in an input item.
namelist | The list of input items which will trigger this `<filled>` element. Optional. (Default is a list of all the form's input items.) This attribute cannot be defined when `<filled>` is in an input item.

Attribute Notes

- An `error.badfetch` event is thrown if `mode` or `namelist` is specified for a `<filled>` within an input item (ex. in a `<field>`).

Parents

<field>, <form>, <object>, <record>, <subdialog>, <transfer>

Children

<assign>, <audio>, <clear>, <data>, <disconnect>, <exit>, <foreach>, <goto>, <if>, <log>, <prompt>, <reprompt>, <return>, <script>, <submit>, <throw>, <value>, <var>, #PCDATA

Extensions

None.

Limitations/Restrictions

None.

Example

    <?xml version="1.0"?>
    <vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">
      <form>
        <field name="field1" type="boolean">
          <prompt> Please say yes or no. </prompt>
          <filled>
            You said <value expr="field1"/>.
          </filled>
        </field>
      </form>
    </vxml>