ModelForms module

InputRadio

Entity for <input type="radio">.

A model in the Forms module, with 29 members for templates, 22 API properties and 27 members for admin templates.

View
What Smarty and Twig templates receive. Properties in REST API responses and job payloads. What admin screen templates receive when you override them.

Templates view

Properties 27

Take no arguments.

# __toString() Templates only
string
Get a string representation of the element => render the output html
# getType()
string
Returns the type of the current element.
# isCurrentlyRequired()
bool
Returns element current required option used in validation
# getOptions()
?array
Returns options array from settings. Returns null if setting is not set or set incorrect (every option should have at least value and title keys). Returns only unique value based on value key. NOTE values are not encoded. You need to encode them before rendering in HTML. Also, remember to encode value when you are comparing them.
# getErrors()
?array
Gets all violations (error messages) related to the element's current submission
# getErrorMessage()
string
Gets error message for the field. If there are several errors for the element, all of them will be added to this message.
# hasErrors()
bool
Returns whether element has at least one error
# getName()
?string
# getEntity()
?string
# getId()
?int
# getHelp()
?string
Gets help text for the element. It could be used as a tooltip or in HTML as a title attribute, e.g. '<input title="{getHelp()}" ...>'.
# getEditor()
?string
# getText()
?string
Text for the element that usually is used for element's label
# getDefaultValue()
?string
# getPlaceholder()
?string
# isRequired()
?bool
# getRegex()
?string
# getPosition()
?int
# getSettings()
?array
# getRevision()
?FormRevision
# getStep()
?Step
# getParent()
?ElementGroup
# getElementId()
?string
# isNewRecord() Not in API & Jobs
bool
Check if the record is a new record
# isHierarchicalModel() Not in API & Jobs
bool
Check whether a model is a hierarchical model, i.e. can have children
# isVersionedModel() Not in API & Jobs
bool
Check whether a model is versioned
# getHtml() Templates only
string

Methods 2

Take arguments. The API serialises only getters that need none.

# getValue(ElementSubmission $submission)
?string
Gets string representation of given submission value. By default, returns values from submission values array (via [[getValues()]] method) imploded by ', '. That is suitable for most of the inputs. For example, InputText is always filled by one value in array, so only one value will be returned. For InputSelect it's ok to use current method if select is not (or was not when was submitted) multiple. If InputSelect (or similar) is multiple, and you use current method, if there is a ',' sing in submitted values, it could be difficult to explode current string then. That's why if InputSelect is "multiple" it's better to use [[getValues()]] method instead. NOTE that submission validness isn't checked here.
# getValues(ElementSubmission $submission)
?array
Gets array representation of given submission value even if it's one value array. By default, returns submission values array. Returns null if values are not set at all. NOTE that submission validness isn't checked here.

API & Jobs view

API & JobsEach property is a key in REST API responses and job payloads. Its name is the template getter without get, is or has. Methods that need arguments are not available here.

Properties 22

Read-only values on the record.

# type
string
Returns the type of the current element.
# currentlyRequired
bool
Returns element current required option used in validation
# options
?array
Returns options array from settings. Returns null if setting is not set or set incorrect (every option should have at least value and title keys). Returns only unique value based on value key. NOTE values are not encoded. You need to encode them before rendering in HTML. Also, remember to encode value when you are comparing them.
# errors
?array
Gets all violations (error messages) related to the element's current submission
# errorMessage
string
Gets error message for the field. If there are several errors for the element, all of them will be added to this message.
# errors
bool
Returns whether element has at least one error
# name
?string
# entity
?string
# id
?int
# help
?string
Gets help text for the element. It could be used as a tooltip or in HTML as a title attribute, e.g. '<input title="{getHelp()}" ...>'.
# editor
?string
# text
?string
Text for the element that usually is used for element's label
# defaultValue
?string
# placeholder
?string
# required
?bool
# regex
?string
# position
?int
# settings
?array
# revision
?FormRevision
# step
?Step
# parent
?ElementGroup
# elementId
?string

Admin view

AdminAvailable in cdna-admin templates. Copy an admin template into your site repository to change how this record is edited.

Properties 25

Take no arguments.

# getType()
string
Returns the type of the current element.
# isCurrentlyRequired()
bool
Returns element current required option used in validation
# getOptions()
?array
Returns options array from settings. Returns null if setting is not set or set incorrect (every option should have at least value and title keys). Returns only unique value based on value key. NOTE values are not encoded. You need to encode them before rendering in HTML. Also, remember to encode value when you are comparing them.
# getErrors()
?array
Gets all violations (error messages) related to the element's current submission
# getErrorMessage()
string
Gets error message for the field. If there are several errors for the element, all of them will be added to this message.
# hasErrors()
bool
Returns whether element has at least one error
# getName()
?string
# getEntity()
?string
# getId()
?int
# getHelp()
?string
Gets help text for the element. It could be used as a tooltip or in HTML as a title attribute, e.g. '<input title="{getHelp()}" ...>'.
# getEditor()
?string
# getText()
?string
Text for the element that usually is used for element's label
# getDefaultValue()
?string
# getPlaceholder()
?string
# isRequired()
?bool
# getRegex()
?string
# getPosition()
?int
# getSettings()
?array
# getRevision()
?FormRevision
# getStep()
?Step
# getParent()
?ElementGroup
# getElementId()
?string
# isNewRecord() Not in API & Jobs
bool
Check if the record is a new record
# isHierarchicalModel() Not in API & Jobs
bool
Check whether a model is a hierarchical model, i.e. can have children
# isVersionedModel() Not in API & Jobs
bool
Check whether a model is versioned

Methods 2

Take arguments. The API serialises only getters that need none.

# getValue(ElementSubmission $submission)
?string
Gets string representation of given submission value. By default, returns values from submission values array (via [[getValues()]] method) imploded by ', '. That is suitable for most of the inputs. For example, InputText is always filled by one value in array, so only one value will be returned. For InputSelect it's ok to use current method if select is not (or was not when was submitted) multiple. If InputSelect (or similar) is multiple, and you use current method, if there is a ',' sing in submitted values, it could be difficult to explode current string then. That's why if InputSelect is "multiple" it's better to use [[getValues()]] method instead. NOTE that submission validness isn't checked here.
# getValues(ElementSubmission $submission)
?array
Gets array representation of given submission value even if it's one value array. By default, returns submission values array. Returns null if values are not set at all. NOTE that submission validness isn't checked here.