abstract class MultiChoiceControl extends BaseControl

Choice control that allows multiple items selection.

Properties

protected bool[] $disabledChoices
array $items

Methods

__construct(string|Stringable|null $label = null, array|null $items = null)

No description

void
loadHttpData()

Loads HTTP data.

setValue($values)

No description

mixed
getValue()

Returns selected keys.

array
getRawValue()

Returns raw submitted keys without validation against the available items.

setItems(array $items, bool $useKeys = true)

Sets items from which to choose. When $useKeys is false, values are used as keys too.

array
getItems()

Returns items from which to choose.

array
getSelectedItems()

Returns key-value pairs for valid, non-disabled selected items.

setDisabled(bool|array $value = true)

Disables or enables control or items.

string
getHtmlName()

Returns HTML name of control.

checkDefaultValue(bool $value = true)

Enables or disables validation that set values exist in the items list.

mixed
getItem(mixed $key)

Returns the item label for the given key, or throws an exception if the key does not exist.

Details

at line 31
__construct(string|Stringable|null $label = null, array|null $items = null)

No description

Parameters

string|Stringable|null $label
array|null $items

at line 40
void loadHttpData()

Loads HTTP data.

Return Value

void

at line 47
Control setValue($values)

internal  
 

No description

Parameters

$values

Return Value

Control

at line 82
mixed getValue()

Returns selected keys.

Return Value

mixed

at line 92
array getRawValue()

Returns raw submitted keys without validation against the available items.

Return Value

array

at line 102
MultiChoiceControl setItems(array $items, bool $useKeys = true)

Sets items from which to choose. When $useKeys is false, values are used as keys too.

Parameters

array $items
bool $useKeys

Return Value

MultiChoiceControl

at line 113
array getItems()

Returns items from which to choose.

Return Value

array

at line 123
array getSelectedItems()

Returns key-value pairs for valid, non-disabled selected items.

Return Value

array

at line 139
BaseControl setDisabled(bool|array $value = true)

Disables or enables control or items.

Parameters

bool|array $value

Return Value

BaseControl

at line 153
string getHtmlName()

Returns HTML name of control.

Return Value

string

at line 162
MultiChoiceControl checkDefaultValue(bool $value = true)

Enables or disables validation that set values exist in the items list.

Parameters

bool $value

Return Value

MultiChoiceControl

at line 172
protected mixed getItem(mixed $key)

Returns the item label for the given key, or throws an exception if the key does not exist.

Parameters

mixed $key

Return Value

mixed