W3cubDocs

/CakePHP 4.4

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.

Namespace: Cake\View\Widget

Property Summary

  • $_select protected
    Cake\View\Widget\SelectBoxWidget

    Select box widget.

  • $_templates protected
    Cake\View\StringTemplate

    StringTemplate instance.

  • $defaults protected
    array<string, mixed>

    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<string, mixed> $data, Cake\View\Form\ContextInterface $context): array<string, mixed>

Merge default values with supplied data.

Parameters

array<string, mixed> $data

Data array

Cake\View\Form\ContextInterface $context

Context instance.

Returns

array<string, mixed>

render() public 

render(array<string, mixed> $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<string, mixed> $data

Data to render with.

Cake\View\Form\ContextInterface $context

The current form context.

Returns

string

secureFields() public 

secureFields(array<string, mixed> $data): array<string>

Returns a list of fields that need to be secured for this widget.

Parameters

array<string, mixed> $data

Returns

array<string>

setMaxLength() protected 

setMaxLength(array<string, mixed> $data, Cake\View\Form\ContextInterface $context, string $fieldName): array<string, mixed>

Set value for "maxlength" attribute if applicable.

Parameters

array<string, mixed> $data

Data array

Cake\View\Form\ContextInterface $context

Context instance.

string $fieldName

Field name.

Returns

array<string, mixed>

setRequired() protected 

setRequired(array<string, mixed> $data, Cake\View\Form\ContextInterface $context, string $fieldName): array<string, mixed>

Set value for "required" attribute if applicable.

Parameters

array<string, mixed> $data

Data array

Cake\View\Form\ContextInterface $context

Context instance.

string $fieldName

Field name.

Returns

array<string, mixed>

setStep() protected 

setStep(array<string, mixed> $data, Cake\View\Form\ContextInterface $context, string $fieldName): array<string, mixed>

Set value for "step" attribute if applicable.

Parameters

array<string, mixed> $data

Data array

Cake\View\Form\ContextInterface $context

Context instance.

string $fieldName

Field name.

Returns

array<string, mixed>

Property Detail

$_select protected

Select box widget.

Type

Cake\View\Widget\SelectBoxWidget

$_templates protected

StringTemplate instance.

Type

Cake\View\StringTemplate

$defaults protected

Data defaults.

Type

array<string, mixed>

© 2005–present The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/4.4/class-Cake.View.Widget.YearWidget.html