Class YearWidget
Input widget class for generating a calendar year select box.
This class is usually used internally by Cake\View\Helper\FormHelper
,
it but can be used to generate standalone calendar year select boxes.
Property Summary
-
$_select protected
Cake\View\Widget\SelectBoxWidget
Select box widget.
-
$_templates protected
Cake\View\StringTemplate
StringTemplate instance.
-
$defaults protected
array
Data defaults.
Method Summary
-
__construct() public
Constructor
-
mergeDefaults() protected
Merge default values with supplied data.
-
render() public
Renders a year select box.
-
secureFields() public
Returns a list of fields that need to be secured for this widget.
-
setMaxLength() protected
Set value for "maxlength" attribute if applicable.
-
setRequired() protected
Set value for "required" attribute if applicable.
-
setStep() protected
Set value for "step" attribute if applicable.
Method Detail
__construct() ¶ public
__construct(Cake\View\StringTemplate $templates, Cake\View\Widget\SelectBoxWidget $selectBox)
Constructor
Parameters
-
Cake\View\StringTemplate
$templates Templates list.
-
Cake\View\Widget\SelectBoxWidget
$selectBox Selectbox widget instance.
mergeDefaults() ¶ protected
mergeDefaults(array $data, Cake\View\Form\ContextInterface $context): array
Merge default values with supplied data.
Parameters
-
array
$data Data array
-
Cake\View\Form\ContextInterface
$context Context instance.
Returns
array
render() ¶ public
render(array $data, Cake\View\Form\ContextInterface $context): string
Renders a year select box.
This method accepts a number of keys:
name
The name attribute.val
The value attribute.escape
Set to false to disable escaping on all attributes.
Any other keys provided in $data will be converted into HTML attributes.
Parameters
-
array
$data Data to render with.
-
Cake\View\Form\ContextInterface
$context The current form context.
Returns
string
secureFields() ¶ public
secureFields(array $data): string[]
Returns a list of fields that need to be secured for this widget.
Parameters
-
array
$data
Returns
string[]
setMaxLength() ¶ protected
setMaxLength(array $data, Cake\View\Form\ContextInterface $context, string $fieldName): array
Set value for "maxlength" attribute if applicable.
Parameters
-
array
$data Data array
-
Cake\View\Form\ContextInterface
$context Context instance.
-
string
$fieldName Field name.
Returns
array
setRequired() ¶ protected
setRequired(array $data, Cake\View\Form\ContextInterface $context, string $fieldName): array
Set value for "required" attribute if applicable.
Parameters
-
array
$data Data array
-
Cake\View\Form\ContextInterface
$context Context instance.
-
string
$fieldName Field name.
Returns
array
setStep() ¶ protected
setStep(array $data, Cake\View\Form\ContextInterface $context, string $fieldName): array
Set value for "step" attribute if applicable.
Parameters
-
array
$data Data array
-
Cake\View\Form\ContextInterface
$context Context instance.
-
string
$fieldName Field name.
Returns
array