Ferreteria/v2/usage/forms: Difference between revisions

From Woozle Writes Code
< Ferreteria‎ | v2‎ | usage
Jump to navigation Jump to search
(significant functions; version 2 imminent)
(some v2 documentation)
Line 4: Line 4:
* '''field''' classes handle translating values between internal storage and on-disk storage (database)
* '''field''' classes handle translating values between internal storage and on-disk storage (database)


Forms are in the process of being rewritten (version 2). The rest of this page applies to version 1.
The Forms classes are being rewritten from scratch; this page applies to the new version (2). Version 1 is [[/v1|here]].
==Rules==
* Every '''control''' (clsCtrl) belongs to a '''control row''' (clsCtrls).
* '''Control row'''s can be indexed in order to allow for multi-row editing.
* '''clsCtrls''' should eventually be renamed '''clsCtrlRow'''.
* I haven't decided if there needs to be a clsForm class for containing multiple control rows.
** Indexing is optional if you're only editing one row at a time.
==Pages==
* {{l/ferreteria/|changes/1}}: change to Save() parameters
{| width=100%
{| width=100%
| valign=top bgcolor=#efe |
| valign=top bgcolor=#efe |
==Files==
==Files==
* {{ferreteria/code|util/forms.php}}
* {{ferreteria/code|forms/ctrl.php}}
** '''clsFields'''
** '''fcFormControl''' (abstract)
** '''clsField'''
*** '''fcFormControl_HTML''' &larr; fcFormControl
*** '''clsFieldTime'''
**** '''fcFormControl_HTML_TextArea''' &larr; fcFormControl_HTML
*** '''clsFieldNum'''
* {{ferreteria/code|forms/field.php}}
*** '''clsFieldBool'''
** '''fcFormField'''
**** '''clsFieldBool_Int'''
*** '''fcFormField_Num''' &larr; fcFormField
** '''clsCtrls''' (abstract)
*** '''fcFormField_Time''' &larr; fcFormField
** '''clsCtrl''' (abstract)
* {{ferreteria/code|forms/form.php}}
*** '''clsCtrlHTML'''
** '''fcForm''' (abstract)
**** '''clsCtrlHTML_CheckBox'''
*** '''fcForm_keyed''' &larr; fcForm
**** '''clsCtrlHTML_DropDown'''
* {{ferreteria/code|forms/form-data.php}}
**** '''clsCtrlHTML_Hidden'''
** '''fcForm_DB''' &larr; fcForm_keyed
**** '''clsCtrlHTML_Fixed'''
**** '''clsCtrlHTML_ReadOnly'''
**** '''clsCtrlHTML_Rating'''
* {{ferreteria/code|form-data.php}}
** {{faint|'''clsCtrls'''}}
*** '''clsForm_recs'''
**** '''clsForm_recs_indexed'''
| valign=top bgcolor=#eef |
| valign=top bgcolor=#eef |
==Classes==
==Classes==
The way this is organized is a little messed up; the descendants of clsCtrls handle database interaction -- but shouldn't it be the descendants of clsFields? It works reasonably well as is, but some rethinking might be a good idea, once everything is all mapped out.
* '''fcForm''' (abstract)
===collections===
** '''fcForm_keyed''' &larr; fcForm
* '''clsCtrls''' (abstract): a collection of '''clsCtrl''' form controls -- often referred to in code as a "form object"
*** '''fcForm_DB''' &larr; fcForm_keyed
** '''clsForm_recs''': form object that knows how to interact with a database table
* '''fcFormField'''
*** '''clsForm_recs_indexed''': form object that knows how to interact with a ''keyed'' database table (allowing for additional functionality)
** '''fcFormField_Num''' &larr; fcFormField
* '''clsFields''': a collection of '''clsField''' objects
** '''fcFormField_Time''' &larr; fcFormField
===unitary objects===
* '''fcFormControl''' (abstract)
* '''clsField''': a generic (unspecialized) field, suitable for plain text
** '''fcFormControl_HTML''' &larr; fcFormControl
** '''clsFieldTime''': field for storing date/time
*** '''fcFormControl_HTML_TextArea''' &larr; fcFormControl_HTML
** '''clsFieldNum''': field for storing numeric (int or float) data
** '''clsFieldBool''': field for storing a BIT-type boolean field (which, oddly, is returned as a single character instead of numeric)
*** should be renamed clsFieldBool_bit, or maybe this class should be abstract and clsFieldBool_bit should descend from it
*** '''clsFieldBool_Int''': field for storing a boolean value stored as an integer
* '''clsCtrl''' (abstract): a generic UI control
** '''clsCtrlHTML''': a control for an HTML form, suitable for single-line text entry
*** '''clsCtrlHTML_TextArea''': HTML multiline text entry control
*** '''clsCtrlHTML_CheckBox''': HTML checkbox control
*** '''clsCtrlHTML_DropDown''': HTML single-choice drop-down control
*** '''clsCtrlHTML_Hidden''': HTML invisible control, for returning calculated data
*** '''clsCtrlHTML_Fixed''': HTML control for displaying pre-set data; useful for creating new records
*** '''clsCtrlHTML_ReadOnly''': HTML control for non-editable data
*** '''clsCtrlHTML_Rating''': HTML control for entering a rating (integer with fixed range and intervals)
|}
|}
==Significant Functions==
==Significant Functions==
* clsCtrls (abstract)
* '''fcForm'''
** function '''Ctrl({{arg|name}})''' &rarr; clsCtrl
** ControlArray({{arg|array of control objects (optional)}}) - set/get all control objects
** function '''FieldsObject()''' &rarr; clsForm_recs_indexed
** ControlObject({{arg|name}},{{arg|control object (optional)}}) - set/get control object for given name
* clsCtrl (abstract)
** AddField({{arg|field object}}, {{arg|control object}})
** function '''Field()''' &rarr; clsField
** LoadRecord() (abstract)
** function '''RowObject()''' &rarr; clsCtrls
** SaveRecord() (abstract)
* clsFields
** RecordValue({{arg|name}},{{arg|value (optional)}}) - set/get field value
** function '''DefaultValues()''' &rarr; array of mixed
** RecordValues({{arg|array of values (optional)}}) - set/get all field values
* clsField
** NewValues({{arg|array of values (optional)}}) - set/get values for new records
** function '''ValStore()''' &rarr; mixed
** ClearValues()
** function '''ValShow()''' &rarr; string
** RenderControls({{arg|edit?}})
 
* clsCtrls &rarr; clsCtrl array
* clsCtrl &rarr;

Revision as of 15:05, 5 April 2015

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

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?>)
Retrieved from "https://wooz.dev/mw/index.php?title=Ferreteria/v2/usage/forms&oldid=2743"