Class FileWidget
Input widget class for generating a file upload control.
This class is usually used internally by Cake\View\Helper\FormHelper,
it but can be used to generate standalone file upload controls.
Property Summary
-
$_templates protected
Cake\View\StringTemplateStringTemplate instance.
-
$defaults protected
array<string, mixed>Data defaults.
Method Summary
-
__construct() public
Constructor.
-
mergeDefaults() protected
Merge default values with supplied data.
-
render() public
Render a file upload form widget.
-
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)Constructor.
Parameters
-
Cake\View\StringTemplate$templates Templates list.
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): stringRender a file upload form widget.
Data supports the following keys:
name- Set the input name.escape- Set to false to disable HTML escaping.
All other keys will be converted into HTML attributes.
Unlike other input objects the val property will be specifically
ignored.
Parameters
-
array<string, mixed>$data The data to build a file input with.
-
Cake\View\Form\ContextInterface$context The current form context.
Returns
stringsecureFields() ¶ public
secureFields(array<string, mixed> $data): list<string>Returns a list of fields that need to be secured for this widget.
Parameters
-
array<string, mixed>$data
Returns
list<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>