This Field Type represents a single selection or multiple choices from a list of options.
Name
Internal name
Expected input type
Selection
ezselection
mixed
Description
The Selection Field Type stores single selections or multiple choices from a list of options, by populating a hash with the list of selected values.
Input expectations
Type
Example
array
array( 1, 2 )
Value object
Properties
The Value class of this Field Type contains the following properties:
Property
Type
Description
$selection
int[]
This property will be used for the list of selections, which will be a list of integer values, or one single integer value.
Value object content examples
Constructor
The Selection\Value constructor accepts an array of selected element identifiers.
Constructor example
String representation
String representation of this Field Type is its list of selections as a string, concatenated with a comma.
Example:
"1,2,24,42"
Hash format
Hash format of this Field Type is the same as Value object's selection property.
Example of value in hash format
Validation
This Field Type validates the input, verifying if all selected options exist in the field definition and checks if multiple selections are allowed in the Field definition. If any of these validations fail, a ValidationErroris thrown, specifying the error message, and for the case of the option validation a list with the invalid options is also presented.
Settings
Name
Type
Default value
Description
isMultiple
boolean
false
Used to allow or deny multiple selection from the option list.
options
hash
array()
Stores the list of options defined in the field definition.
