Class: I2CE FormField

From IHRIS Wiki
Revision as of 23:13, 16 October 2009 by Litlfred (talk | contribs)

This article desrcibes the1 class I2CE_FormField.

Class for defining all the database fields used by a I2CE_Form 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.

  • Type: protected ng $name

$options

An associative array with all the options for this form field.

  • Type: protected y $options

$value

The value of this field.

$headers

A list of headers for this form field.

  • Type: protected y $headers

$href

A URL to be used as a link for this field when displaying the value.

  • Type: protected ng $href

$form

A reference to the form object this field is a part of.

$history

A list of I2CE_Entry objects for all entries for this field.

  • Type: protected y $history

$history_idx

The index for cycling through all historical entries.

  • Type: protected nteger $history_idx

$attributes

A list of attributes for this FormField instance.

  • Type: protected y $attributes

$invalid

error messages to be displayed when a form is invalid. . string or array of "extra" setInvalid

  • Type: protected mixed $invalid

Methods

__construct()

Create a new instance of a I2CE_FormField unique and unique_field

  • Signature: public function __construct($name,$options)

Parameters:

  • string $name
  • array $options
    A list of options for this form field. The keys used are: in_db, required,
    • Default Value: array()

addHistory()

Add a history entry to this field.

  • Signature: public function addHistory($entry)

Parameters:

compare()

Compares this form field agains the given form field.

  • Signature: public function compare($db_value)
  • Returns: -1,0,1

Parameters:

  • mixed $db_value
    Either a DB Value or an I2CE_FormField

createField()

Instantiantiate a field given its short class name

  • Signature: static public function createField($formfield,$name,$args)
  • Returns: mixed I2CE_FormField or false on failure

Parameters:

  • string $formfield
    the short name of a form field (e.g. STRING_LINE or DATE_YMD)
  • string $name
    The name of the field
  • array $args
    Defaults to empty array. The field arguments passed to the constructor
    • Default Value: array()

displayInvalid()

Displays invalid/error messages on the given node @var I2CE_Template $template @var DOMNode $node

  • Signature: protected function displayInvalid($template,$node)

Parameters:

  • $template
  • $node

firstHistory()

Reset the {@link history_idx history index} and return the first element

  • Signature: public function firstHistory()
  • Returns: DBEntry

getAttribute()

Return the attribute value for a given attribute.

  • Signature: public function getAttribute($key)
  • Returns: mixed

Parameters:

getDBType()

Return the DB field type for this type.

  • Signature: public function getDBType()
  • Returns: string

getDBValue()

Returns the value of this field ready to be stored in the database.

  • Signature: public function getDBValue()
  • Returns: mixed

getDisplayNode()

Return the display value of this form field as a DOM Node.

  • Signature: public function getDisplayNode($node,$template)
  • Returns: DOMNode

Parameters:

getDisplayValue()

Returns the value of this field as a human readable format. entry for this field.

  • Signature: public function getDisplayValue($entry)
  • Returns: mixed

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
    • Default Value: false

getDisplays()

Get the display styles registered for this form field. Will always include 'default'

  • Signature: public function getDisplays()
  • Returns: array

getElement()

  • Signature: protected function getElement()

getForm()

Returns the form object for this field.

  • Signature: public function getForm()

getFromDB()

Return the value of this field from the database format for the given type

  • Signature: public function getFromDB($value)

Parameters:

getHTMLName()

Return the value for the name attribute to be used for this field in a form.

  • Signature: public function getHTMLName($prefix)
  • Returns: string

Parameters:

  • $prefix
    • Default Value: 'fields'

getHeader()

Return the given header by type

  • Signature: public function getHeader($type)

Parameters:

  • string $type
    • Default Value: "default"

getHref()

Return the URL to be used as a link for this field for display.

  • Signature: public function getHref()
  • Returns: string

getInvalid()

Return the invalid information.

  • Signature: public function getInvalid()
  • Returns: array

getMDB2Type()

Return the MDB2 field type for this field. If it isn't set return the DB type.

  • Signature: public function getMDB2Type()
  • Returns: string

getName()

Returns the field name of this field.

  • Signature: public function getName()
  • Returns: string

getOption()

Get the value stored at a named option exists

  • Signature: public function getOption($option)
  • Returns: mixed

Parameters:

getOptionsByPath()

  • Signature: protected function getOptionsByPath($path)

Parameters:

  • $path

getString()

Return the type string for this field.

  • Signature: public function getString()
  • Returns: string

getTypeString()

Return the string name for a given type.

  • Signature: public function getTypeString()
  • Returns: string

getValue()

Returns the value of this field.

  • Signature: public function getValue()
  • Returns: mixed

hasAttribute()

Return true if a given attribute exists for this form.

  • Signature: public function hasAttribute($key)
  • Returns: boolean;

Parameters:

hasDisplay()

Checks to see if the given display type is registed for this form field.

  • Signature: public function hasDisplay($type)
  • Returns: boolean

Parameters:

  • string $type
    The display type. 'default' always returns true

hasHeader()

Check to see if the given header type exists

  • Signature: public function hasHeader($type)

Parameters:

  • string $type
    • Default Value: "default"

hasInvalid()

Checks to see if there are any entries in the invalid array.

  • Signature: public function hasInvalid()
  • Returns: boolean

hasNextHistory()

Check to see if there are remaining DBEntry elements in history array.

  • Signature: public function hasNextHistory()
  • Returns: boolean

hasOption()

Check if a named option exists

  • Signature: public function hasOption($option)
  • Returns: boolean

Parameters:

isInDB()

Checks to see if this field is saved in the database.

  • Signature: public function isInDB()
  • Returns: boolean

isSameValue()

Check to see if the given DB value is equivalent to this value.

  • Signature: public function isSameValue($db_value)
  • Returns: boolean

Parameters:

  • mixed $db_value
    Either a DB Value or an I2CE_FormField

isValid()

Checks to see if the current value for this is set and valid.

  • Signature: abstract public function isValid()
  • Returns: boolean

issetValue()

Checks to see if the value has been set.

  • Signature: public function issetValue()
  • Returns: boolean

nextHistory()

Return the next DBEntry element from the history array.

  • Signature: public function nextHistory()
  • Returns: DBEntry

optionsHasPath()

  • 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.

  • Signature: public function processDOM($node,$template)

Parameters:

processDOMEditable()

  • Signature: abstract public function processDOMEditable($node,$template,$form_node)
  • Returns: array of DOMNode

Parameters:

  • $node
  • $template
  • $form_node

processDOMNotEditable()

  • Signature: public function processDOMNotEditable($node,$template,$form_node)

Parameters:

setAttribute()

Set an attribute for this form.

  • Signature: public function setAttribute($key,$value)

Parameters:

setElement()

  • Signature: protected function setElement($element)

Parameters:

  • $element

setForm()

Sets the form object for this field.

  • Signature: public function setForm($form)

Parameters:

setFromDB()

Sets the value of this field from the database format.

  • Signature: public function setFromDB($value)

Parameters:

setFromPost()

Sets the value of this field from the posted form.

  • Signature: public function setFromPost($post)

Parameters:

setHeaders()

Set the headers for this form field.

  • Signature: public function setHeaders($headers)

Parameters:

setHref()

Set the URL for this field

  • Signature: public function setHref($href)

Parameters:

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.

  • Signature: public function setInvalid($message,$extra)

Parameters:

  • string $message
    The error message to display.
  • array $extra
    Any extra information to be formatted and displayed.
    • Default Value: null

setValue()

Sets the value of this field.

  • Signature: public function setValue($value)

Parameters:

unsetValue()

Unsets the value of this field.

  • Signature: public function unsetValue()

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()

Retrieved from "https://wiki.ihris.org/mediawiki/index.php?title=Class:_I2CE_FormField&oldid=7454"