formFromVars

• record [0]

Represents actual record as array of fields.

• errors [1]

Represents actual errors as array of fields. Field can also be an array.

• data [2]

Overloads $defaultData during template's execution. Names should be without dollar signs. Ex:

 array('row', 'errors.row', 'data');
 $errors`['row']` = array(
   'field1' => 'one error',
   'field2' => array('first error', 'second error')
 );

• text (default)
• password
• hidden
• checkbox
• radio
• textarea Convention:

 'fieldName' => array(
   'fieldType', $fieldOptions
 )

• label
• id
• multiple (only select) // TODO
• values (only radio, MANDATORY)
• value (only checkbox, optional) There can be special field __form, which represents form element, as an array. All values from it will be pushed as form attributes. If you wrap fields' array within another array, it will represent fieldsets, which value with index __label will be used as legend (optional).

 $defaultRecord = array(
     'text-field' => 'text-field default value',
     'select-field' => 'bar2',
     'select-field-optgroups-multiple' => array('group2_1', 'group2_2'),
     'checkbox-field' => false,
 );

 $defaultData = array(
     'select-field-optgroups' => array(
         array(    // 1st optgroup
             '__label' => 'optgroup 1 label',
             'group1_1' => 'group1_1 label',
             'group1_2' => 'group1_2 label',
         ),
         array(    // 2nd optgroup
             '__label' => 'optgroup 2 label',
             'group2_1' => 'group2_1 label',
             'group2_2' => 'group2_2 label',
         ),
         'bar' => 'Bar',    // no optgroup
     ),
 );

 $templates`['__checkbox']` = '
 <div class="input">
     <div>Checkbox field below</div>
   <label/>
   <input/>
 </div>';

 <div class="input">
   <label/>
   <input/>
   <ul class="errors">
     <li/>
   </ul>
 </div>

• error - selects field's error wrapper
• dafault value is '.errors'
• label - selects field's label node (can be div, span, etc)
• default value is 'label:first'
• use array to per field name selector, 'default' means default
• input - selects field's input node: input, textarea or select
• default value is 'input:first'
• use array to per field name selector, 'default' means default
• %t is replaced by field node type (use it with customized per field $template)