Form methods

When a form has been created, you can retrieve it by its name by calling var contactForm = jQuery.iForm.getForm('contact');.

The following methods are available on the form object:

• fill(values) where values is an associative array (keys are field identifiers and values are field values). The specified field values are set and become the new initial values for those fields. Unspecified fields remain unchanged. Example:

  contact.fill({
     FirstName:'Bob',
     Profession:'A02',
     Referrer:3,
     Comment:'none'
  });
  

• read() retrieves all the current form values in an associative array (keys are field identifiers and values are field values). Example:

  contact.read();

  returns:

  {
     FirstName:'Sam',
     Age:23,
     Profession:'J01',
     Email:'sam@example.com',
     ProEmail:false,
     Pass:'secret',
     Referrer:1,
     Comment:'please send me a sample'
  }

• cancel() brings the form back to its initial state. Each field value is set back to its initial value. The initial value of a field is its value in the HTML code or the value set by a call to the fill method.
• isFormDirty() returns true if at least one of its field is dirty. A field is dirty if its current value is different from its initial value.
• saved() tells the form that the current field values are the new initial values. Field values are unchanged, and the field becomes not dirty.