Textarea field, for entering multiline text.

This class provides a basic input field. This includes : - getting data from a database or via html variables - Privileges for handling and showing data - displaying the data in a form or as text

category Form
package Formaid
author Dieter Adriaenssens
copyright 2006-2013 Dieter Adriaenssens
license GPL
link http://formaid.sourceforge.net/

 Methods

Initialises an instance of a Formaid_FieldTextArea class.

__construct(string $field_name, string $current_value, string $title, string $comment) : void

Defines current value and default value.

Parameters

$field_name

string

Name of the input field.

$current_value

string

Initial value.

$title

string

Title/caption that precedes this field.

$comment

string

Comment that is shown after this field.

Checks if INSERT of the value of this field in an SQL record is allowed.

allowSqlInsert() : bool
Inherited

If the Privileges on this field ( allow_change and allow_sql_insert) are set, it is allowed to insert the value of this field.

inherited_from \Formaid_FieldInputAbstract::allowSqlInsert()

Returns

booltrue if insert is allowed.

Checks if SELECTing the value of this field from an SQL record is allowed.

allowSqlSelect() : bool
Inherited

If the Privileges on this field (allow_show) is set, it is allowed to select the value of this field.

inherited_from \Formaid_FieldInputAbstract::allowSqlSelect()

Returns

booltrue if select is allowed.

Checks if UPDATE of the value of this field in an SQL record is allowed.

allowSqlUpdate() : bool
Inherited

If the Privileges on this field ( allow_change and allow_sql_update) are set, it is allowed to update the value of this field.

inherited_from \Formaid_FieldInputAbstract::allowSqlUpdate()

Returns

booltrue if update is allowed.

Disables trimming whitespace of object name

disableTrimName() : void
Inherited
inherited_from \Formaid_Object::disableTrimName()
inherited_from \Formaid_Property::disableTrimName()
inherited_from \Formaid_FieldInputAbstract::disableTrimName()

Display object

display() : void
Inherited

The name of the object is printed to stdout.

inherited_from \Formaid_Object::display()
inherited_from \Formaid_Property::display()
inherited_from \Formaid_FieldInputAbstract::display()

Enables trimming whitespace of object name

enableTrimName() : void
Inherited
inherited_from \Formaid_Object::enableTrimName()
inherited_from \Formaid_Property::enableTrimName()
inherited_from \Formaid_FieldInputAbstract::enableTrimName()

Get display seperator

getDisplaySeparator() : string
Inherited
inherited_from \Formaid_Property::getDisplaySeparator()
inherited_from \Formaid_FieldInputAbstract::getDisplaySeparator()

Returns

stringString separating columns

Generates the HTML string for this element

getDisplayString() : string
Inherited

If the mode is form, a form element is shown : this includes a title, html tags and a comment If the mode is value, only the values of a record are shown: this includes a title and the value in human readable form.

inherited_from \Formaid_FieldInputAbstract::getDisplayString()

Returns

string

Returns the html-code for the input field properties

getFieldPropertiesHtmlString() : string

Returns

string

Returns a html string of the object.

getHtmlString() : string

A field objected is converted to a html string to display it in a web page or web form.

Returns

stringhtml string

Returns name of the object

getName() : string
Inherited
inherited_from \Formaid_Object::getName()
inherited_from \Formaid_Property::getName()
inherited_from \Formaid_FieldInputAbstract::getName()

Returns

stringobject name

Returns current value

getValue() : string
Inherited
inherited_from \Formaid_Property::getValue()
inherited_from \Formaid_FieldInputAbstract::getValue()

Returns

stringcurrent value

Returns a value formatted to show on a web page.

getValueDisplayString(bool $specialchars) : string

The value of the database is a multiline string, so every new line (nl) will be converted to a
html tag.

Parameters

$specialchars

bool

Convert with htmlspecialchars, default = no

Returns

string

Checks if current value is empty

isEmpty() : bool
Inherited
inherited_from \Formaid_Property::isEmpty()
inherited_from \Formaid_FieldInputAbstract::isEmpty()

Returns

booltrue if empty

Checks if object name is empty

isNameEmpty() : bool
Inherited
inherited_from \Formaid_Object::isNameEmpty()
inherited_from \Formaid_Property::isNameEmpty()
inherited_from \Formaid_FieldInputAbstract::isNameEmpty()

Returns

booltrue if empty

Reads value in the $_GET array

readGetValue() : void
Inherited

The field value on a form is submitted and made available by the webserver in the $_GET array, This function checks if the value exist and sets the value of this object.

inherited_from \Formaid_FieldInputAbstract::readGetValue()

Reads variables submitted with webpage

readPageRequestVariable() : void
Inherited

Reads value in the $_POST and $_GET arrays.

inherited_from \Formaid_FieldInputAbstract::readPageRequestVariable()

Reads value in the $_POST array

readPostValue() : void
Inherited

The field value on a form is submitted and made available by the webserver in the $_POST array, This function checks if the value exist, applies encoding and sets the value of this object.

inherited_from \Formaid_FieldInputAbstract::readPostValue()

Reads value from an sql-row array

readSqlValue(array $sql_row) : void
Inherited

This function checks if the value exist and sets the value of this object.

inherited_from \Formaid_FieldInputAbstract::readSqlValue()

Parameters

$sql_row

array

row from sql_result

Resets current value

resetValue() : void
Inherited

Empty current value

inherited_from \Formaid_Property::resetValue()
inherited_from \Formaid_FieldInputAbstract::resetValue()

Sets current value to default

setDefault(string $value) : void
Inherited

When the parameter is set, the default value is changed to the new default value. Then the current value is set to the (new) default value.

inherited_from \Formaid_Property::setDefault()
inherited_from \Formaid_FieldInputAbstract::setDefault()

Parameters

$value

string

New default value

Sets new name for the object

setName(string $new_name) : void
Inherited
inherited_from \Formaid_Object::setName()
inherited_from \Formaid_Property::setName()
inherited_from \Formaid_FieldInputAbstract::setName()

Parameters

$new_name

string

new name

Set field value

setValue(string $value) : void
Inherited
inherited_from \Formaid_FieldInputAbstract::setValue()

Parameters

$value

string

Field value

Show object

show() : void
Inherited

The name of the object is printed to stdout.

inherited_from \Formaid_Object::show()
inherited_from \Formaid_Property::show()
inherited_from \Formaid_FieldInputAbstract::show()

Validates value of the object.

validateValue() : bool
Inherited
inherited_from \Formaid_FieldInputAbstract::validateValue()

Returns

booltrue if value is valid.

Returns name formatted for displaying

getDisplayName() : string
Inherited
inherited_from \Formaid_Object::getDisplayName()
inherited_from \Formaid_Property::getDisplayName()
inherited_from \Formaid_FieldInputAbstract::getDisplayName()

Returns

stringformatted object name

Returns value formatted for displaying

getDisplayValue() : string
Inherited
access protected
inherited_from \Formaid_Property::getDisplayValue()
inherited_from \Formaid_FieldInputAbstract::getDisplayValue()

Returns

stringformatted object value

Updates the value of the input field status

_updateStatus() : void
Inherited

When the input field is disabled, Privilege allow_change is false, the status is set to disabled. In all other cases, the status is set to default (= active).

access private
inherited_from \Formaid_FieldInputAbstract::_updateStatus()

 Properties

 

$auto_update : bool
Inherited
access public
inherited_from \Formaid_FieldInputAbstract::$$auto_update
 

$cols : integer
access public
todo set private, provide setter setSize($cols, $rows)
 

$comment : string
Inherited
access public
inherited_from \Formaid_FieldInputAbstract::$$comment
 

$layout_class : string
Inherited
access public
inherited_from \Formaid_FieldInputAbstract::$$layout_class
 

$privileges : array
Inherited
access public
inherited_from \Formaid_FieldInputAbstract::$$privileges
 

$properties : array
Inherited
access public
inherited_from \Formaid_FieldInputAbstract::$$properties
 

$rows : integer
access public
todo set private, provide setter setSize($cols, $rows)
 

$title : string
Inherited
access public
inherited_from \Formaid_FieldInputAbstract::$$title
 

$urlReturnParamEnable : bool
Inherited

Default : not enabled

access public
inherited_from \Formaid_FieldInputAbstract::$$urlReturnParamEnable
 

$urlReturnParamName : string
Inherited

Default is the field name.

access public
inherited_from \Formaid_FieldInputAbstract::$$urlReturnParamName
 

$current_value : string
Inherited
access protected
inherited_from \Formaid_Property::$$current_value
inherited_from \Formaid_FieldInputAbstract::$$current_value
 

$default_value : string
Inherited
access protected
inherited_from \Formaid_Property::$$default_value
inherited_from \Formaid_FieldInputAbstract::$$default_value
 

$displaySeparator : string
Inherited
access protected
inherited_from \Formaid_Property::$$displaySeparator
inherited_from \Formaid_FieldInputAbstract::$$displaySeparator
 

$encoding : string
Inherited
access protected
inherited_from \Formaid_Object::$$encoding
inherited_from \Formaid_Property::$$encoding
inherited_from \Formaid_FieldInputAbstract::$$encoding
 

$name : string
Inherited
access protected
inherited_from \Formaid_Object::$$name
inherited_from \Formaid_Property::$$name
inherited_from \Formaid_FieldInputAbstract::$$name
 

$status : string
Inherited

Used to transfer the status when submitting a form.

access public
inherited_from \Formaid_FieldInputAbstract::$$status
 

$_trimName : bool
Inherited
access private
inherited_from \Formaid_Object::$$_trimName
inherited_from \Formaid_Property::$$_trimName
inherited_from \Formaid_FieldInputAbstract::$$_trimName