类 YearWidget
用于生成日历年份选择框的输入小部件类。
此类通常由 Cake\View\Helper\FormHelper
内部使用,但可以用于生成独立的日历年份选择框。
命名空间: Cake\View\Widget
属性摘要
-
$_select protected
Cake\View\Widget\SelectBoxWidget
选择框小部件。
-
$_templates protected
Cake\View\StringTemplate
StringTemplate 实例。
-
$defaults protected
array<string, mixed>
数据默认值。
方法摘要
-
__construct() public
构造函数
-
mergeDefaults() protected
将默认值与提供的數據合併。
-
render() public
渲染年份选择框。
-
secureFields() public
返回需要为此小部件进行安全保护的字段列表。
-
setMaxLength() protected
如果适用,设置 "maxlength" 属性的值。
-
setRequired() protected
如果适用,设置 "required" 属性的值。
-
setStep() protected
如果适用,设置 "step" 属性的值。
方法詳情
__construct() ¶ public
__construct(Cake\View\StringTemplate $templates, Cake\View\Widget\SelectBoxWidget $selectBox)
构造函数
参数
-
Cake\View\StringTemplate
$templates 模板列表。
-
Cake\View\Widget\SelectBoxWidget
$selectBox Selectbox 小部件实例。
mergeDefaults() ¶ protected
mergeDefaults(array<string, mixed> $data, Cake\View\Form\ContextInterface $context): array<string, mixed>
将默认值与提供的數據合併。
参数
-
array<string, mixed>
$data 数据数组
-
Cake\View\Form\ContextInterface
$context 上下文实例。
返回
array<string, mixed>
render() ¶ public
render(array<string, mixed> $data, Cake\View\Form\ContextInterface $context): string
渲染年份选择框。
此方法接受多个键
name
name 属性。val
value 属性。escape
设置为 false 以禁用对所有属性的转义。
$data 中提供的任何其他键将被转换为 HTML 属性。
参数
-
array<string, mixed>
$data 要渲染的数据。
-
Cake\View\Form\ContextInterface
$context 当前表单上下文。
返回
string
secureFields() ¶ public
secureFields(array<string, mixed> $data): list<string>
返回需要为此小部件进行安全保护的字段列表。
参数
-
array<string, mixed>
$data
返回
list<string>
setMaxLength() ¶ protected
setMaxLength(array<string, mixed> $data, Cake\View\Form\ContextInterface $context, string $fieldName): array<string, mixed>
如果适用,设置 "maxlength" 属性的值。
参数
-
array<string, mixed>
$data 数据数组
-
Cake\View\Form\ContextInterface
$context 上下文实例。
-
string
$fieldName 字段名称。
返回
array<string, mixed>
setRequired() ¶ protected
setRequired(array<string, mixed> $data, Cake\View\Form\ContextInterface $context, string $fieldName): array<string, mixed>
如果适用,设置 "required" 属性的值。
参数
-
array<string, mixed>
$data 数据数组
-
Cake\View\Form\ContextInterface
$context 上下文实例。
-
string
$fieldName 字段名称。
返回
array<string, mixed>
setStep() ¶ protected
setStep(array<string, mixed> $data, Cake\View\Form\ContextInterface $context, string $fieldName): array<string, mixed>
如果适用,设置 "step" 属性的值。
参数
-
array<string, mixed>
$data 数据数组
-
Cake\View\Form\ContextInterface
$context 上下文实例。
-
string
$fieldName 字段名称。
返回
array<string, mixed>