Blazorise FileInput component
Input component with support for single of multi file upload.
API
Parameters
| Parameter | Default | Type |
|---|---|---|
AriaDescribedBy | — | string |
Specifies the aria-describedby attribute value. When set, this value is rendered as-is and overrides help and validation message ids generated by Field and Validation. | ||
AriaInvalid | — | string |
Specifies the aria-invalid attribute value. When set, this value is rendered as-is and overrides the validation-derived aria-invalid state. | ||
AriaLabelledBy | — | string |
Specifies the aria-labelledby attribute value. When set, this value is rendered as-is. Some non-labelable controls can otherwise derive it automatically from a parent FieldLabel or FieldsLabel. | ||
AriaRequired | false | bool |
Specifies the aria-required attribute value. When set, this value overrides the required-field state resolved from the parent Validation. | ||
Autofocus | false | bool |
Set's the focus to the component after the rendering is done. | ||
AutoReset | true | bool |
If true file input will be automatically reset after it has being uploaded. | ||
BrowseButtonLocalizer | null | TextLocalizerHandler |
Function used to handle custom localization that will override a default ITextLocalizer. | ||
ChildContent | null | RenderFragment |
Specifies the content to be rendered inside this FileInput. | ||
Directory | false | bool |
Determines whether file picker should upload directories. | ||
Disabled | false | bool |
Add the disabled boolean attribute on an input to prevent user interactions and make it appear lighter. | ||
DisableProgressReport | false | bool |
Determines whether report progress should be disabled. By enabling this setting, Progressed and Written callbacks won't be called. Internal file progress won't be tracked. This setting can speed up file transfer considerably. | ||
Feedback | null | RenderFragment |
Placeholder for validation messages. | ||
Filter | — | string |
Specifies the types of files that the input accepts. See w3schools.com. | ||
MaxChunkSize | 20 * 1024 | int |
Specifies the max chunk size when uploading the file. Take note that if you're using IFileEntry,CancellationToken) you're provided with a stream and should configure the chunk size when handling with the stream. See docs.microsoft.com. | ||
MaxFileSize | long.MaxValue | long |
Maximum file size in bytes, checked before starting upload (note: never trust client, always check file size at server-side). Defaults to long.MaxValue. | ||
Multiple | false | bool |
Enables the multiple file selection. | ||
Placeholder | — | string |
Sets the placeholder for the empty file input. | ||
ReadOnly | false | bool |
Add the readonly boolean attribute on an input to prevent modification of the input’s value. | ||
SegmentFetchTimeout | TimeSpan.FromMinutes( 1 ) | TimeSpan |
Specifies the Segment Fetch Timeout when uploading the file. | ||
Size | Default | Size? |
Sets the size of the input control. When omitted, uses the parent Addons size, then the theme input size, then Size.Default. | ||
TabIndex | null | int? |
If defined, indicates that its element can be focused and can participates in sequential keyboard navigation. | ||
Value | null | TValue |
Specifies the value inside the input field. | ||
ValueExpression | null | Expression<Func<TValue>> |
Specifies an expression that identifies the input value. | ||
Events
| Event | Type |
|---|---|
Blur | EventCallback<FocusEventArgs> |
The blur event fires when an element has lost focus. | |
Changed | EventCallback<FileChangedEventArgs> |
Occurs every time the selected file has changed, including when the reset operation is executed. | |
CustomValidationValue | Func<TValue> |
Used to provide custom validation value on which the validation will be processed with the Validator handler. Should be used carefully as it's only meant for some special cases when input is used in a wrapper component, like Autocomplete or SelectList. | |
Ended | EventCallback<FileEndedEventArgs> |
Notifies when an individual file upload has ended. | |
FocusIn | EventCallback<FocusEventArgs> |
Notifies when the input box gains focus. | |
FocusOut | EventCallback<FocusEventArgs> |
Notifies when the input box loses focus. | |
KeyDown | EventCallback<KeyboardEventArgs> |
Notifies when a key is pressed down while the control has focus. | |
KeyPress | EventCallback<KeyboardEventArgs> |
Notifies when a key is pressed while the control has focus. | |
KeyUp | EventCallback<KeyboardEventArgs> |
Notifies when a key is released while the control has focus. | |
OnFocus | EventCallback<FocusEventArgs> |
Notifies when the input box gains or loses focus. | |
Progressed | EventCallback<FileProgressedEventArgs> |
Notifies the progress of file being written to the destination stream. | |
Started | EventCallback<FileStartedEventArgs> |
Notifies when an individual file upload has started. | |
ValueChanged | EventCallback<TValue> |
Occurs after value has changed. | |
Written | EventCallback<FileWrittenEventArgs> |
Occurs every time the part of file has being written to the destination stream. | |
Methods
| Method | Return | Parameters |
|---|---|---|
NotifyChange | Task | FileEntry[] files |
Notifies the component that file input value has changed.
| ||
OpenReadStream | Stream | IFileEntry fileEntry, CancellationToken cancellationToken |
Opens the stream for reading the uploaded file.
| ||
RemoveFileEntry | Task | IFileEntry fileEntry, CancellationToken cancellationToken |
Removes the file entry from js dictionary.
| ||
RemoveFile | ValueTask | int fileId |
Removes a file from the current file selection.
| ||
Reset | ValueTask | — |
Manually resets the input file value.
| ||
ShowPicker | Task | — |
Show a browser picker for the file input.
| ||
UpdateFileEndedAsync | Task | IFileEntry fileEntry, bool success, FileInvalidReason fileInvalidReason |
Notifies the component that file upload has ended.
| ||
UpdateFileProgressAsync | Task | IFileEntry fileEntry, long progressProgress |
Updated the component with the latest upload progress.
| ||
UpdateFileStartedAsync | Task | IFileEntry fileEntry |
Notifies the component that file upload is about to start.
| ||
UpdateFileWrittenAsync | Task | IFileEntry fileEntry, long position, byte[] data |
Updates component with the latest file data.
| ||
WriteToStreamAsync | Task | IFileEntry fileEntry, Stream stream, CancellationToken cancellationToken |
Writes the file data to the target stream.
| ||
Focus | Task | bool scrollToElement |
Sets the focus on the underline element.
| ||
Revalidate | Task | — |
Forces the Validation (if any is used) to re-validate with the new custom or internal value.
| ||