Class DataList

Responsibility: init, pre-dispatch and render <datalist> HTML element with given options, optionally translated. This field has no possible value to submit. It just renders the <datalist> with given options.

MvcCore\Ext\Forms\Field implements MvcCore\Ext\Forms\IField uses MvcCore\Ext\Forms\Field\Props, MvcCore\Ext\Forms\Field\Getters, MvcCore\Ext\Forms\Field\Setters, MvcCore\Ext\Forms\Field\Rendering

MvcCore\Ext\Forms\Fields\DataList implements MvcCore\Ext\Forms\Fields\IOptions uses MvcCore\Ext\Forms\Field\Props\Options

Namespace: MvcCore\Ext\Forms\Fields
Located at ext-form/src/MvcCore/Ext/Forms/Fields/DataList.php

Methods summary
`public boolean`	# `GetTranslateOptions( )` Get if options has to be translated or not. Get if options has to be translated or not. Returns boolean Implementation of `MvcCore\Ext\Forms\Fields\IOptions::GetTranslateOptions()`
`public MvcCore\Ext\Forms\Field`	# `SetTranslateOptions( boolean $translateOptions = TRUE )` Set `TRUE` to translate given options or not. Set `TRUE` to translate given options or not. Parameters `$translateOptions` Returns `MvcCore\Ext\Forms\Field` Implementation of `MvcCore\Ext\Forms\Fields\IOptions::SetTranslateOptions()`
`public MvcCore\Ext\Forms\Fields\DataList\|MvcCore\Ext\Forms\Field`	# `SetForm( MvcCore\Ext\IForm $form )` This INTERNAL method is called from `\MvcCore\Ext\Form` after field is added into form instance by `$form->AddField();` method. Do not use this method even if you don't develop any form field. - Check if field has any name, which is required. - Set up form and field id attribute by form id and field name. - Set up required. - Set up translate options boolean property. This INTERNAL method is called from `\MvcCore\Ext\Form` after field is added into form instance by `$form->AddField();` method. Do not use this method even if you don't develop any form field. - Check if field has any name, which is required. - Set up form and field id attribute by form id and field name. - Set up required. - Set up translate options boolean property. Parameters `$form` Returns `MvcCore\Ext\Forms\Fields\DataList`\|`MvcCore\Ext\Forms\Field` Throws InvalidArgumentException Overrides `MvcCore\Ext\Forms\Field::SetForm()`
`public`	# `PreDispatch( )` This INTERNAL method is called from `\MvcCore\Ext\Form` just before field is naturally rendered. It sets up field for rendering process. Do not use this method even if you don't develop any form field. - Set up field render mode if not defined. - Translate options if necessary. This INTERNAL method is called from `\MvcCore\Ext\Form` just before field is naturally rendered. It sets up field for rendering process. Do not use this method even if you don't develop any form field. - Set up field render mode if not defined. - Translate options if necessary. Overrides `MvcCore\Ext\Forms\Field::PreDispatch()`
`public null`	# `Submit( array & $rawRequestParams = [] )` This INTERNAL method is called from `\MvcCore\Ext\Form` in submit processing. Do not use this method even if you don't develop form library or any form field. This INTERNAL method is called from `\MvcCore\Ext\Form` in submit processing. Do not use this method even if you don't develop form library or any form field. Return always `NULL` for this `<datalist>` pseudo-field. Parameters `$rawRequestParams` Raw request params from MvcCore request object based on raw app input, `$_GET` or `$_POST`. Returns null Overrides `MvcCore\Ext\Forms\Field::Submit()`
`public string`	# `RenderControl( )` This INTERNAL method is called from `\MvcCore\Ext\Forms\Field\Rendering` in rendering process. Do not use this method even if you don't develop any form field. This INTERNAL method is called from `\MvcCore\Ext\Forms\Field\Rendering` in rendering process. Do not use this method even if you don't develop any form field. Render control tag only without label or specific errors. Render `<datalist>` element, it has not allowed any additional attributes. There is allowed only attribute `id` and `<option>` sub tags. Returns string Overrides `MvcCore\Ext\Forms\Field\Rendering::RenderControl()`

Methods inherited from MvcCore\Ext\Forms\Field
`AddValidationError(), CreateInstance(), GetValidatorData(), __call(), __construct(), __get(), __set(), throwNewInvalidArgumentException(), translateAndFormatValidationError()`

Methods inherited from MvcCore\Ext\Forms\IField
AddControlAttrs(), AddCssClasses(), AddError(), AddValidators(), GetControlAttr(), GetControlAttrs(), GetCssClasses(), GetCssSupportingFile(), GetId(), GetJsClassName(), GetJsSupportingFile(), GetName(), GetTemplates(), GetTitle(), GetType(), GetValidators(), GetValue(), GetViewScript(), HasValidator(), RemoveValidator(), Render(), RenderControlInsideLabel(), RenderErrors(), RenderLabel(), RenderLabelAndControl(), RenderNaturally(), RenderTemplate(), SetControlAttr(), SetControlAttrs(), SetCssClasses(), SetCssSupportingFile(), SetId(), SetJsClassName(), SetJsSupportingFile(), SetName(), SetTemplate(), SetTemplates(), SetTitle(), SetTranslate(), SetType(), SetValidators(), SetValue(), SetViewScript()

Methods inherited from MvcCore\Ext\Forms\Fields\IOptions
`AddOptions(), GetFlattenOptions(), GetOptions(), SetOptions()`

Methods used from MvcCore\Ext\Forms\Field\Props\Options
`AddOptions(), GetFlattenOptions(), GetOptions(), SetOptions()`

Methods used from MvcCore\Ext\Forms\Field\Getters
`GetControlAttr(), GetControlAttrs(), GetCssClasses(), GetCssSupportingFile(), GetId(), GetJsClassName(), GetJsSupportingFile(), GetName(), GetTemplates(), GetTitle(), GetTranslate(), GetType(), GetValidators(), GetValue(), GetViewScript(), HasValidator()`

Methods used from MvcCore\Ext\Forms\Field\Setters
`AddControlAttrs(), AddCssClasses(), AddError(), AddValidators(), RemoveValidator(), SetControlAttr(), SetControlAttrs(), SetCssClasses(), SetCssSupportingFile(), SetId(), SetJsClassName(), SetJsSupportingFile(), SetName(), SetTemplate(), SetTemplates(), SetTitle(), SetTranslate(), SetType(), SetValidators(), SetValue(), SetViewScript()`

Methods used from MvcCore\Ext\Forms\Field\Rendering
`Render(), RenderControlInsideLabel(), RenderErrors(), RenderLabel(), RenderLabelAndControl(), RenderNaturally(), RenderTemplate(), renderAttrsWithFieldVars(), renderControlAttrsWithFieldVars(), renderLabelAttrsWithFieldVars()`

Constants inherited from MvcCore\Ext\Forms\IField
`AUTOFOCUS_DUPLICITY_EXCEPTION, AUTOFOCUS_DUPLICITY_QUIETLY_SET_NEW, AUTOFOCUS_DUPLICITY_UNSET_OLD_SET_NEW, LABEL_SIDE_LEFT, LABEL_SIDE_RIGHT`

Properties summary
`protected string`	`$type` Possible value: `data-list`, not used in HTML code for this field. Possible value: `data-list`, not used in HTML code for this field.	# `'data-list'`
`protected boolean\|null`	`$translateOptions` Translate given options or not. Translate given options or not.	# `NULL`
`protected static array`	`$templates` No templates needed. No templates needed.	# `[]`

Properties used from MvcCore\Ext\Forms\Field\Props
`$controlAttrs, $cssClasses, $cssSupportingFile, $declaredProtectedProperties, $errors, $form, $id, $jsClassName, $jsSupportingFile, $name, $title, $translate, $translateTitle, $validators, $value, $view, $viewScript`

Properties used from MvcCore\Ext\Forms\Field\Props\Options
`$flattenOptions, $options`

Classes

Interfaces

Traits

Exceptions

Functions

Class DataList

Returns

Implementation of

Parameters

Returns

Implementation of

Parameters

Returns

Throws

Overrides

Overrides

Parameters

Returns

Overrides

Returns

Overrides