类 FileWidget
用于生成文件上传控件的输入小部件类。
此类通常由 Cake\View\Helper\FormHelper 内部使用，但可以用于生成独立的文件上传控件。
命名空间: Cake\View\Widget
属性摘要
-
$_templates protected
Cake\View\StringTemplateStringTemplate 实例。
-
$defaults protected
array<string, mixed>数据默认值。
方法摘要
-
__construct() public
构造函数。
-
mergeDefaults() protected
将默认值与提供的 data 合并。
-
render() public
渲染文件上传表单小部件。
-
secureFields() public
返回需要为该小部件保护的字段列表。
-
setMaxLength() protected
如果适用，设置“maxlength”属性的值。
-
setRequired() protected
如果适用，设置“required”属性的值。
-
setStep() protected
如果适用，设置“step”属性的值。
方法详情
__construct() ¶ public
__construct(Cake\View\StringTemplate $templates)构造函数。
参数
-
Cake\View\StringTemplate$templates 模板列表。
mergeDefaults() ¶ protected
mergeDefaults(array<string, mixed> $data, Cake\View\Form\ContextInterface $context): array<string, mixed>将默认值与提供的 data 合并。
参数
-
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- 设置输入名称。escape- 设置为 false 以禁用 HTML 转义。
所有其他键将被转换为 HTML 属性。与其他输入对象不同，val 属性将被专门忽略。
参数
-
array<string, mixed>$data 用于构建文件输入的数据。
-
Cake\View\Form\ContextInterface$context 当前表单上下文。
返回
stringsecureFields() ¶ 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>