jFormsControlGroup
extends jFormsControlGroups
in package
group control.
Contains a list of controls. If it has a checkbox, child controls can be disabled by the user. The "value" of the group is then the status of the checkbox "on" or "". if the group is in readonly mode or is deactivated, every children are readonly or deactivated
Tags
Table of Contents
- $alertInvalid : string
- $alertRequired : string
- $datatype : jDatatype
- $defaultValue : mixed
- $emptyValueLabel : string
- $hasCheckbox : mixed
- indicates if the group has a checkbox to enable/disable its child controls.
- $help : string
- $hint : string
- $initialActivation : bool
- $initialReadOnly : bool
- $label : string
- $ref : string
- $required : bool
- $type : string
- $valueLabelOnCheck : mixed
- If the group has a checkbox, label that is displayed when the value has to be displayed, when the checkbox is checked.
- $valueLabelOnUncheck : mixed
- If the group has a checkbox, label that is displayed when the value has to be displayed, when the checkbox is unchecked.
- $valueOnCheck : mixed
- value that is stored when the checkbox is checked.
- $valueOnUncheck : mixed
- value that is stored when the checkbox is unchecked.
- $attributes : array<string|int, mixed>
- $childControls : mixed
- all child controls of the group.
- $container : jFormsDataContainer
- $form : jFormsBase
- __construct() : mixed
- addChildControl() : mixed
- check() : null|int
- check and filter the value of the control.
- deactivate() : mixed
- getAttribute() : mixed
- getChildControls() : mixed
- getDisplayValue() : mixed
- getWidgetType() : string
- isActivated() : bool
- check if the control is activated.
- isContainer() : mixed
- says if the control can have multiple values.
- isHtmlContent() : mixed
- says if the content is html or not.
- isModified() : mixed
- isReadOnly() : bool
- check if the control is readonly.
- setAttribute() : mixed
- setData() : mixed
- setDataFromDao() : mixed
- setForm() : mixed
- setReadOnly() : mixed
- setValueFromRequest() : mixed
- _diffValues() : bool
Properties
$alertInvalid
public
string
$alertInvalid
= ''
the message when the value is invalid
$alertRequired
public
string
$alertRequired
= ''
the message when there is no value and it is required
$datatype
public
jDatatype
$datatype
the object that manage constraints on the value
$defaultValue
public
mixed
$defaultValue
= ''
the value when the form is created (and not initialized by a data source
$emptyValueLabel
public
string
$emptyValueLabel
label displayed when only values are displayed, and when there is no value
$hasCheckbox
indicates if the group has a checkbox to enable/disable its child controls.
public
mixed
$hasCheckbox
= alse
Tags
$help
public
string
$help
= ''
the message for the help on the control (typically help displayed in a popup)
$hint
public
string
$hint
= ''
the message for tips on the control (typically the tooltip value)
$initialActivation
public
bool
$initialActivation
= rue
$initialReadOnly
public
bool
$initialReadOnly
= alse
indicate if the control is in read only mode
$label
public
string
$label
= ''
the label
$ref
public
string
$ref
= ''
the identifiant of the control
$required
public
bool
$required
= alse
true if the control should be filled by the user
$type
public
string
$type
= 'group'
a type name that identify the control type
$valueLabelOnCheck
If the group has a checkbox, label that is displayed when the value has to be displayed, when the checkbox is checked.
public
mixed
$valueLabelOnCheck
= ''
If empty, the value of valueOnCheck is displayed.
Tags
$valueLabelOnUncheck
If the group has a checkbox, label that is displayed when the value has to be displayed, when the checkbox is unchecked.
public
mixed
$valueLabelOnUncheck
= ''
If empty, the value of valueOnUncheck is displayed.
Tags
$valueOnCheck
value that is stored when the checkbox is checked.
public
mixed
$valueOnCheck
= '1'
Tags
$valueOnUncheck
value that is stored when the checkbox is unchecked.
public
mixed
$valueOnUncheck
= '0'
Tags
$attributes
protected
array<string|int, mixed>
$attributes
= array()
miscellaneous values attached to the control
$childControls
all child controls of the group.
protected
mixed
$childControls
= array()
$container
protected
jFormsDataContainer
$container
content all values of the form
$form
protected
jFormsBase
$form
the form object
Methods
__construct()
public
__construct(string $ref) : mixed
Parameters
- $ref : string
-
the identifiant of the control
Return values
mixed —addChildControl()
public
addChildControl(mixed $control[, mixed $itemName = '' ]) : mixed
Parameters
- $control : mixed
- $itemName : mixed = ''
Return values
mixed —check()
check and filter the value of the control.
public
check() : null|int
It is the responsability of the implementation to fill the "errors" or "data" properties of the container.
Return values
null|int —null if it is ok, or one of jForms::ERRDATA_* constants when there is an error
deactivate()
public
deactivate([mixed $deactivation = true ]) : mixed
Parameters
- $deactivation : mixed = true
Return values
mixed —getAttribute()
public
getAttribute(mixed $name) : mixed
Parameters
- $name : mixed
Return values
mixed —getChildControls()
public
getChildControls() : mixed
Return values
mixed —getDisplayValue()
public
getDisplayValue(mixed $value) : mixed
Parameters
- $value : mixed
Return values
mixed —getWidgetType()
public
getWidgetType() : string
Tags
Return values
string —the default widget type to use to render the control
isActivated()
check if the control is activated.
public
isActivated() : bool
Return values
bool —true if it is activated
isContainer()
says if the control can have multiple values.
public
isContainer() : mixed
Return values
mixed —isHtmlContent()
says if the content is html or not.
public
isHtmlContent() : mixed
Tags
Return values
mixed —isModified()
public
isModified() : mixed
Return values
mixed —isReadOnly()
check if the control is readonly.
public
isReadOnly() : bool
Return values
bool —true if it is readonly
setAttribute()
public
setAttribute(mixed $name, mixed $value) : mixed
Parameters
- $name : mixed
- $value : mixed
Return values
mixed —setData()
public
setData(mixed $value) : mixed
Parameters
- $value : mixed
Return values
mixed —setDataFromDao()
public
setDataFromDao(mixed $value, mixed $daoDatatype) : mixed
Parameters
- $value : mixed
- $daoDatatype : mixed
Return values
mixed —setForm()
public
setForm(jFormsBase $form) : mixed
Parameters
- $form : jFormsBase
Return values
mixed —setReadOnly()
public
setReadOnly([mixed $r = true ]) : mixed
Parameters
- $r : mixed = true
Return values
mixed —setValueFromRequest()
public
setValueFromRequest(mixed $request) : mixed
Parameters
- $request : mixed
Return values
mixed —_diffValues()
protected
_diffValues(mixed &$v1, mixed &$v2) : bool
Parameters
- $v1 : mixed
- $v2 : mixed
Return values
bool —true if the values are not equals