Class: I2CE FormField (4.0.2)
This article describes the abstract class I2CE_FormField .
- Extends the class: I2CE_Fuzzy.
- Child Classes:
- Location: Part of the module forms in the package I2CE 4.0.2-release
- Source: Defined in the file modules/Forms/lib/I2CE_FormField.php on line 31
- Author: Luke Duncan <lduncan@intrahealth.org>
- Since: v2.0.0
Class for defining all the database fields used by a object.
Constants
I2CE_FormField::FIELD_TYPE_I2CE
A string type for the field Defined as: "string"
I2CE_FormField::FIELD_TYPE_DB
The database type for the field Defined as: "varchar( 255 ) COLLATE utf8_bin default NULL"
I2CE_FormField::FIELD_TYPE_MDB2
The MDB2 type for the field. Defined as: "text"
Variables
$name
The name of this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 50
- Type: protected string $name
$options
An associative array with all the options for this form field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 54
- Type: protected array $options
$value
The value of this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 58
- Type: protected mixed $value
$headers
A list of headers for this form field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 62
- Type: protected array $headers
$href
A URL to be used as a link for this field when displaying the value.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 66
- Type: protected string $href
$form
A reference to the form object this field is a part of.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 70
- Type: protected I2CE_Form $form
$history
A list of objects for all entries for this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 74
- Type: protected array $history
$history_idx
The index for cycling through all historical entries.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 78
- Type: protected integer $history_idx
$attributes
A list of attributes for this FormField instance.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 82
- Type: protected array $attributes
$invalid
error messages to be displayed when a form is invalid. . string or array of "extra" setInvalid
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 162
- Type: protected mixed $invalid
Methods
__construct()
Create a new instance of a I2CE_FormField
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 173
- Signature: public function __construct($name,$options)
- Parameters:
addHistory()
Add a history entry to this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 523
- Signature: public function addHistory($entry)
- Parameters:
- I2CE_Entry $entry
The historical entry
- I2CE_Entry $entry
compare()
Compares this form field agains the given form field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 454
- Signature: public function compare($db_value)
- Parameters:
- mixed $db_value
Either a DB Value or an I2CE_FormField
- mixed $db_value
- Returns: -1,0,1
createField()
Instantiantiate a field given its short class name
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 94
- Signature: static public function createField($formfield,$name,$args)
- Parameters:
- Returns: mixed
I2CE_FormField or false on failure
displayInvalid()
Displays invalid/error messages on the given node @var I2CE_Template $template @var DOMNode $node
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 805
- Signature: protected function displayInvalid($template,$node)
- Parameters:
- $template
- $node
firstHistory()
Reset the history_idx history index and return the first element
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 543
- Signature: public function firstHistory()
- Returns: DBEntry
getAttribute()
Return the attribute value for a given attribute.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 863
- Signature: public function getAttribute($key)
- Parameters:
- string $key
- Returns: mixed
getDBType()
Return the DB field type for this type.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 207
- Signature: public function getDBType()
- Returns: string
getDBValue()
Returns the value of this field ready to be stored in the database.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 412
- Signature: public function getDBValue()
- Returns: mixed
getDisplayNode()
Return the display value of this form field as a DOM Node.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 582
- Signature: public function getDisplayNode($node,$template)
- Parameters:
- DOMNode $node
- I2CE_Template $template
- Returns: DOMNode
getDisplayValue()
Returns the value of this field as a human readable format.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 422
- Signature: public function getDisplayValue($entry)
- Parameters:
- I2CE_Entry $entry
If a I2CE_Entry object has been passed to this method then it will return the value for that entry assuming it's an entry for this field.- Default Value: false
- I2CE_Entry $entry
- Returns: mixed
getDisplays()
Get the display styles registered for this form field. Will always include 'default'
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 343
- Signature: public function getDisplays()
- Returns: array
getElement()
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 835
- Signature: protected function getElement()
getForm()
Returns the form object for this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 359
- Signature: public function getForm()
getFromDB()
Return the value of this field from the database format for the given type
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 229
- Signature: public function getFromDB($value)
- Parameters:
- mixed $value
getHTMLName()
Return the value for the name attribute to be used for this field in a form.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 367
- Signature: public function getHTMLName($prefix)
- Parameters:
- $prefix
- Default Value: 'fields'
- $prefix
- Returns: string
getHeader()
Return the given header by type
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 510
- Signature: public function getHeader($type)
- Parameters:
- string $type
- Default Value: "default"
- string $type
getHref()
Return the URL to be used as a link for this field for display.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 568
- Signature: public function getHref()
- Returns: string
getInvalid()
Return the invalid information.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 154
- Signature: public function getInvalid()
- Returns: array
getMDB2Type()
Return the MDB2 field type for this field. If it isn't set return the DB type.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 216
- Signature: public function getMDB2Type()
- Returns: string
getName()
Returns the field name of this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 237
- Signature: public function getName()
- Returns: string
getOption()
Get the value stored at a named option exists
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 268
- Signature: public function getOption($option)
- Parameters:
- string $option
- Returns: mixed *
getOptionsByPath()
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 305
- Signature: protected function getOptionsByPath($path)
- Parameters:
- $path
getString()
Return the type string for this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 244
- Signature: public function getString()
- Returns: string
getTypeString()
Return the string name for a given type.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 199
- Signature: public function getTypeString()
- Returns: string
getValue()
Returns the value of this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 404
- Signature: public function getValue()
- Returns: mixed
hasAttribute()
Return true if a given attribute exists for this form.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 876
- Signature: public function hasAttribute($key)
- Parameters:
- string $key
- Returns: boolean;
hasDisplay()
Checks to see if the given display type is registed for this form field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 328
- Signature: public function hasDisplay($type)
- Parameters:
- string $type
The display type. 'default' always returns true
- string $type
- Returns: boolean
hasHeader()
Check to see if the given header type exists
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 503
- Signature: public function hasHeader($type)
- Parameters:
- string $type
- Default Value: "default"
- string $type
hasInvalid()
Checks to see if there are any entries in the invalid array.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 139
- Signature: public function hasInvalid()
- Returns: boolean
hasNextHistory()
Check to see if there are remaining DBEntry elements in history array.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 531
- Signature: public function hasNextHistory()
- Returns: boolean
hasOption()
Check if a named option exists
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 260
- Signature: public function hasOption($option)
- Parameters:
- string $option
- Returns: boolean *
isInDB()
Checks to see if this field is saved in the database.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 251
- Signature: public function isInDB()
- Returns: boolean
isSameValue()
Check to see if the given DB value is equivalent to this value.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 436
- Signature: public function isSameValue($db_value)
- Parameters:
- mixed $db_value
Either a DB Value or an I2CE_FormField
- mixed $db_value
- Returns: boolean
isValid()
Checks to see if the current value for this is set and valid.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 470
- Signature: abstract public function isValid()
- Returns: boolean
issetValue()
Checks to see if the value has been set.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 477
- Signature: public function issetValue()
- Returns: boolean
nextHistory()
Return the next DBEntry element from the history array.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 552
- Signature: public function nextHistory()
- Returns: DBEntry
optionsHasPath()
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 289
- Signature: protected function optionsHasPath($path)
- Parameters:
- $path
processDOM()
Process this form field as a DOM element to place it in the template at the given node.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 601
- Signature: public function processDOM($node,$template)
- Parameters:
- DOMNode $node
- I2CE_Template $template
processDOMEditable()
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 846
- Signature: abstract public function processDOMEditable($node,$template,$form_node)
- Parameters:
- $node
- $template
- $form_node
- Returns: array
of DOMNode
processDOMNotEditable()
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 789
- Signature: public function processDOMNotEditable($node,$template,$form_node)
- Parameters:
- DOMNode $node
- I2CE_Template $template
- DOMNode $form_node
setAttribute()
Set an attribute for this form.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 854
- Signature: public function setAttribute($key,$value)
- Parameters:
setElement()
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 839
- Signature: protected function setElement($element)
- Parameters:
- $element
setForm()
Sets the form object for this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 281
- Signature: public function setForm($form)
- Parameters:
- I2CE_Form $form
setFromDB()
Sets the value of this field from the database format.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 388
- Signature: public function setFromDB($value)
- Parameters:
- mixed $value
setFromPost()
Sets the value of this field from the posted form.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 396
- Signature: public function setFromPost($post)
- Parameters:
- mixed $post
setHeaders()
Set the headers for this form field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 492
- Signature: public function setHeaders($headers)
- Parameters:
- array $headers
setHref()
Set the URL for this field
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 560
- Signature: public function setHref($href)
- Parameters:
- string $href
setInvalid()
Add or replace an entry in the invalid array. The format for the $extra parameter is: array( "URL" => array( 'id' => 'display' ) ); The id value will be appended to the URL and the display part will be displayed as the link text.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 125
- Signature: public function setInvalid($message,$extra)
- Parameters:
setValue()
Sets the value of this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 381
- Signature: public function setValue($value)
- Parameters:
- mixed $value
unsetValue()
Unsets the value of this field.
- Defined in i2ce/modules/Forms/lib/I2CE_FormField.php on line 483
- Signature: public function unsetValue()
Inherited Methods
_hasMethod()
This public method is inherited from I2CE_Fuzzy->_hasMethod()
Inherited Fuzzy Methods
userMessage()
This method is inherited from I2CE_Fuzzy->userMessage()
Fuzzy Methods
cachedTableReference()
This method is implemented by I2CE_Module_CachedForms->cachedTableReference()
isNumeric()
This method is implemented by I2CE_Module_CustomReports->isNumericField()
getLimitStyles()
This method is implemented by I2CE_Module_FormLimits->getFieldLimitStyles()
generateLimit()
This method is implemented by I2CE_Module_FormLimits->generateFieldLimit()
generateLimit_null()
This method is implemented by I2CE_Module_FormLimits->generateLimit_null()
generateLimit_not_null()
This method is implemented by I2CE_Module_FormLimits->generateLimit_not_null()
generateLimit_null_not_null()
This method is implemented by I2CE_Module_FormLimits->generateLimit_not_null()
checkLimit_null()
This method is implemented by I2CE_Module_FormLimits->checkLimit_null()
checkLimit_not_null()
This method is implemented by I2CE_Module_FormLimits->checkLimit_not_null()
checkLimit_null_not_null()
This method is implemented by I2CE_Module_FormLimits->checkLimit_not_null()
checkLimitString_null()
This method is implemented by I2CE_Module_FormLimits->checkLimitString_null()
checkLimitString_not_null()
This method is implemented by I2CE_Module_FormLimits->checkLimitString_not_null()
checkLimitString_null_not_null()
This method is implemented by I2CE_Module_FormLimits->checkLimitString_not_null()
getLimitMenu_null()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_null()
getLimitMenu_not_null()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_not_null()
getLimitMenu_null_not_null()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_null_not_null()
processLimitMenu_null()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_null()
processLimitMenu_not_null()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_not_null()
processLimitMenu_null_not_null()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_null_not_null()
generateLimit_max_parent()
This method is implemented by I2CE_Module_FormLimits->generateLimit_max_parent()
generateLimit_min_parent()
This method is implemented by I2CE_Module_FormLimits->generateLimit_min_parent()
generateLimit_max_parent_form()
This method is implemented by I2CE_Module_FormLimits->generateLimit_max_parent_form()
generateLimit_min_parent_form()
This method is implemented by I2CE_Module_FormLimits->generateLimit_min_parent_form()
getLimitMenu_max_parent()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_max_parent()
getLimitMenu_min_parent()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_min_parent()
getLimitMenu_max_parent_form()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_max_parent_form()
getLimitMenu_min_parent_form()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_DISPLAYFIELDSTYLE_min_parent_form()
processLimitMenu_max_parent()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_max_parent()
processLimitMenu_min_parent()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_min_parent()
processLimitMenu_max_parent_form()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_max_parent_form()
processLimitMenu_min_parent_form()
This method is implemented by I2CE_Module_FormLimits->I2CE_FormField_PROCESSFIELDSTYLE_min_parent_form()
save()
This method is implemented by I2CE_FormStorage->FF_save()
populateHistory()
This method is implemented by I2CE_FormStorage->FF_populateHistory()