Ferreteria/v2/usage/forms

About

Forms in Ferreteria consist of several sets of classes that work together:

• control classes render editable (and eventually non-editable) data fields
• field classes handle translating values between internal storage and on-disk storage (database)

The Forms classes are being rewritten from scratch; this page applies to the new version (2). Version 1 is here.

Files Template:Ferreteria/code fcFormControl (abstract) fcFormControl_HTML ← fcFormControl fcFormControl_HTML_TextArea ← fcFormControl_HTML Template:Ferreteria/code fcFormField fcFormField_Num ← fcFormField fcFormField_Time ← fcFormField Template:Ferreteria/code fcForm (abstract) fcForm_keyed ← fcForm Template:Ferreteria/code fcForm_DB ← fcForm_keyed

Classes fcForm (abstract) fcForm_keyed ← fcForm fcForm_DB ← fcForm_keyed fcFormField fcFormField_Num ← fcFormField fcFormField_Time ← fcFormField fcFormControl (abstract) fcFormControl_HTML ← fcFormControl fcFormControl_HTML_TextArea ← fcFormControl_HTML

Significant Functions

• fcForm
  • ControlArray(<array of control objects (optional)>) - set/get all control objects
  • ControlObject(<name>,<control object (optional)>) - set/get control object for given name
  • AddField(<field object>, <control object>)
  • LoadRecord() (abstract)
  • SaveRecord() (abstract)
  • RecordValue(<name>,<value (optional)>) - set/get field value
  • RecordValues(<array of values (optional)>) - set/get all field values
  • NewValues(<array of values (optional)>) - set/get values for new records
  • ClearValues()
  • RenderControls(<edit?>)