Jelix 1.7.18

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
subpackage

forms

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

$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
since
1.6.2

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

$initialReadOnly

public bool $initialReadOnly = alse

indicate if the control is in read only mode

$required

public bool $required = alse

true if the control should be filled by the user

$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
since
1.6.2

$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
since
1.6.2

$valueOnCheck

value that is stored when the checkbox is checked.

public mixed $valueOnCheck = '1'
Tags
since
1.6.2

$valueOnUncheck

value that is stored when the checkbox is unchecked.

public mixed $valueOnUncheck = '0'
Tags
since
1.6.2

$attributes

protected array<string|int, mixed> $attributes = array()

miscellaneous values attached to the control

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

getDisplayValue()

public getDisplayValue(mixed $value) : mixed
Parameters
$value : mixed
Return values
mixed

getWidgetType()

public getWidgetType() : string
Tags
since
1.6.14
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
since
1.2
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

setDataFromDao()

public setDataFromDao(mixed $value, mixed $daoDatatype) : mixed
Parameters
$value : mixed
$daoDatatype : mixed
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

Search results