Skip to main content

File Upload

The File Upload component is an interactive UI element that simplifies file transfers by allowing users to easily upload files to the server.

info

The File Upload component has an Icon element embedded within it. This is of great importance as configuring the File Upload component may require adjusting properties within the embedded element. This applies to the visual style, triggers, and actions as they may differ.

Use Cases

The File Upload component finds valuable application in diverse scenarios, including:

  • Document Management: Facilitate efficient document uploads and storage for improved organization.

  • Media Sharing: Allow users to upload images, videos, or audio files for seamless sharing with others.

  • File Archiving: Provide users with a means to securely store and retrieve essential files or records.

Properties Customization

File Upload Component

Enhance the File Upload component to align with your application's requirements using the following customization options:

  • Label: Personalize the label to offer clear instructions or guidance.
  • Icon Position: Choose the position of the icon in relation to the label, allowing options for top, bottom, left, right, or even hidden.
  • Size Limit: Define the maximum file size users are allowed to upload. Choose from units such as KB, MB, and GB.

  • If a user attempts to upload a file exceeding the specified size, an error message is displayed in the browser.
  • Media Type: Specify the supported file types that can be uploaded using the component. Supported types include text, image, video, and audio.

Embedded Icon

Within the File Upload component, an embedded Icon allows for further customization of the following properties:

  • Icon: When the icon visibility is configured in the File Upload component's customization properties, you can select an icon from an icon picker list.

Data Integration

The File Upload component uses data-binding to link user interactions with the underlying data structure.

info

The qodlysource for the File Upload component can take the form of either a Blob or a Picture.

Data Binding

Bind the component to an attribute of Blob or Picture type within an entity qodlysource. This specific attribute will serve as the storage location for the uploaded file.
tip

Alternatively, you can establish the connection by dragging and dropping the qodlysource onto the File Upload component.

Showcase

Here's a glimpse of how the File Upload component will look and behave in action:

Triggers and Events

File Upload Component

The File Upload component can respond to various events, enabling dynamic user experiences. Events that can trigger actions within the component include:

EventDescription
On ClickCalls for an action when the user clicks on the component.
On BlurCalls for an action when the component loses focus (user clicks outside).
On FocusCalls for an action when the component gains focus (user clicks on it).
On MouseEnterCalls for an action when the user's mouse cursor enters the area of the component.
On MouseLeaveCalls for an action when the user's mouse cursor exits the area of the component.
On KeyDownCalls for an action when a keyboard key is pressed down while the component is in focus.
On KeyupCalls for an action when a keyboard key is released while the component is in focus

Embedded Icon

The embedded Icon can also respond to various events, allowing for dynamic user experiences. Events that can trigger actions within the embedded icon include:

EventDescription
On ClickCalls for an action when the user clicks on the Icon.
On KeyupCalls for an action when a keyboard key is released while the Icon is in focus
On KeyDownCalls for an action when a keyboard key is pressed down while the Icon is in focus.
On MouseEnterCalls for an action when the user's mouse cursor enters the area of the Icon.
On MouseLeaveCalls for an action when the user's mouse cursor exits the area of the Icon.