# File Upload

## Basic #### Text The text to be displayed to indicate the user to upload the file. Usually, the word 'Browse' is part of this text to make it more meaningful to the users. #### Upload Type | | | | --------- | --------------------------------------------- | | Single | Only one FILE can be uploaded at a time | | Multiple | MULTIPLE files can be uploaded at a time | | Directory | An entire DIRECTORY can be attached at a time | #### Use Drop zone It shows a large empty box for users to drag and drop the file or folder, along with the standard option to browse and select the file. ## Validation #### Min Size Defines the minimum file size to be uploaded. It is measured in 'kb'. An error message will be thrown if a file is uploaded which is smaller than this value. #### Max Size Defines the maximum file size to be uploaded. It is measured in 'kb'. An error message will be thrown when users try to upload a file larger than the given size. ## Interaction #### Event Handlers | Event | Description | | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **`Change`** |

The "Change" event is activated when the value of the widget is changed. When this event triggers, the associated action gets executed.

| | **`Parse`** |

This event is triggered when the uploaded file is parsed through, that is-, when the content of the file is being read and parsed by the program.

| #### Disabled Disables the user interaction with the element on the page. It visually indicates that the element is inactive and prevents users from interacting with it when applied. Shows a red-crossed warning symbol and can be customized to disable the widget according to certain conditions using low-code.

#### Hide This sets whether the widget has to be displayed on the screen when the program is loaded. This shows/hides the widget both on desktop and mobile devices.

#### Tooltip Tooltips display additional information upon mouse hover. This information will be contextual, useful, and informative. The tooltip will be immediately shown when the user's mouse hovers over the widget, and immediately hides when the user's mouse leaves.

## Advanced #### File Types Define the comma-separated list of file types. The widget will accept only files with the mentioned extension(s). #### Prefix Icon Choose one from the set of icons that will be displayed as a prefix logo, just before the button text.

#### Suffix Icon Choose one from the set of icons that will be displayed as a suffix logo, just after the logo text.

#### Show Upload List Users can view the list of files uploaded onto the widget currently. #### Parse Files The selected files are processed by the program, and are converted into objects or arrays. These parsed formats are accessed for development purposes. The formats supported for parsing are-: Excel, JSON, CSV, TXT. ## Layout #### Height | | | | ----- | ------------------------------------------- | | Auto | The height is auto-adjusted for the content | | Fixed | The height of the widget is fixed | ## Style

Property	Description
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Text	Set the colour of the text. Recommended to set in contrast with the background.
Text Transform	This property specifies how to capitalize an element's text. It can be used to make text appear in all-uppercase or all-lowercase, or with each word capitalized. MDN web docs
Text Decoration	This property sets the appearance of decorative lines on text. Types are "underline", "overline", "line-though", "overline-underline".
Text Size	Set the size of the text in px value - 12px
Text Weight	Increase or decrease the thickness of the font using the list of numbers from 100-800.
Font Family	Type the name of the font family. The reference to the list of font families can be found here: MDN web docs
Font Style	There are 3 types of styles that can be applied: "normal" - The text is shown normally, no style applied. "italic" - The text is cursive. "oblique" - A sloped version of the normal text.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Margin	This value is set in terms of "px" number which creates the space between the border and the content of the widget.
Padding	This value is set in terms of "px" number which creates the space between the border and outer elements.
Border Radius	This sets the radius of the widget's corners, enabling rounded corners on the widget. This value is defined in "px" terms.
Border Width	Set the thickness of the border of the widget using this value. It is defined using "px" terms.
Box Shadow	The is the colour of the shadow that is generated behind the widget box. The X and Y axis values can be altered such that the shadow can be set to fall anywhere behind the widget area. "x-offset" - a positive number specifies the shadow will be on the right of the box, and a negative number will put the shadow on the left of the box. "y-offset" - a negative one means the shadow will be above the box, and a positive number means the shadow will be below the box. "Blur" - if the number is set to 0 then the shadow will be sharp. It will more blurred as the number goes higher, and the shadow will extend further away. "Color" - sets the colour of the shadow. If the colour is not set, the box shadows are drawn in the foreground colour.
Hover Color	Set the background colour for the widget when the user moves the mouse over it.
Prefix Icon Color	Choose a specific color for the icon that appears before the actual widget content.
Suffix Icon Color	Choose a specific color for the icon that appears after the actual widget content.
Prefix Icon Size	Set the size of the prefix icon in px value - 12px
Suffix Icon Size	Set the size of the suffix icon in px value - 12px

#### Custom CSS Users can write a specific style using CSS syntax here and the style text will be applied to the widget when the program is loaded.