====== < filled > ======

===== Description =====

The < filled > element specifies an action to perform when some combinations of fields are filled by user input.  It may occur as a child of the element, or as a child of a field item.

===== Syntax =====

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

===== Attributes =====

|mode|This attribute cannot be defined when it is in a field item.  There are 2 filled modes, all any.  This attribute is optional and the default is all. all – the action is executed when all of the fields in namelist attribute are filled, and at least one has been filled by the last user input. any – the action is executed when any of the specified fields are filled by the last user input.|
|namelist|This attribute cannot be defined when it is in a field item.  The namelist defines the fields to trigger. This attribute is optional and the default is list of all form’s field items.|

===== Parents =====

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

===== Children =====

<code>
<assign>, <audio>, <clear>, <disconnect>, <enumerate>, <exit>, <goto>, <if>, <prompt>, <reprompt>, <return>, <script>, <submit>, <throw>, <value>, <var>
</code>

===== Extensions =====

<code>
None.
</code>

===== Limitations/Restrictions =====

<code>
None.
</code>

===== Example Code =====

<code>
<?xml version="1.0"?>
<vxml version="2.0" xmlns="http://www.w3.org/2001/vxml">
 <var name="card_type" expr="'amex'" />
 <form>
  <field name="card_num" type="digits">
   <prompt>What is your card number?</prompt>
   <filled>
    <if cond="card_type == 'amex' &amp;&amp; card_num.length != 15">
     American Express card numbers must have 15 digits.
     <clear namelist="card_num"/>
    <elseif cond="card_type != 'amex' &amp;&amp; card_num.length != 16"/>
     Mastercard and Visa card numbers have 16 digits.
     <clear namelist="card_num"/>
    </if>
   </filled>
  </field>
 </form>
</vxml>
</code>