FileUpload

Description

File uploads are used to browse file(s) for upload from the users system.

See live demos on storybook

Storybook FileUpload Demos

Install from Artifactory

• Verify that you have access to (https://docs.int.bayer.com/cloud/devops/artifactory/)[Bayer Artifactory]
  • Verify your token is correctly set up in your .npmrc as per the link above
• Verify you have the @element scope configured in your .npmrc
  • @element:registry=https://artifactory.bayer.com/artifactory/api/npm/npm-platforms-engineering/
• Install the component and themes bundles
  • npm i @element/react-components @element/themes
    • alternatively install the component individually along with the themes bundle npm i @element/react-file-upload @element/themes

Notes

File uploads are used to browse file(s) for upload from the user's system. The file is actually uploaded by the parent application.

Using References & Imperative Functions

File Upload supports the use of React references. You will receive an object with a reference to the table and the following imperative functions:

{
    clear, // Function to clear the file values after uploading is complete
    btnRef, // Ref to the browse file button
    urlInput, // Ref to the url or file name input that displays the file name(s)
    input; // Ref to the input that holds the file value, located inside the button
}

Please see the File upload demos for example usage.

File Upload Props

| Name | Type | Default | Required | Description | | ----------- | ------- | ---------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | className | string | undefined | false | The css class name to be passed through to the component markup. | | disabled | boolean | false | false | Prevent the user from interacting with the component. | | id | string | undefined | false | Randomly generated id. May be overwritten. | | label | string | null | false | Label to be displayed on the button. | | multiple | boolean | false | false | Allows for multiple files to be uploaded. | | placeholder | string | 'No File Chosen' | false | Placeholder text for the file name readonly input. | | themeColor | string | 'primary' | false | Override the default (primary) color with the secondary color. Most commonly used when the control is placed on a darker surface.Accepted Values: primary, secondary |

File Upload Render Props

| Name | Type | Default | Required | Description | | -------- | --------------- | ------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | children | React.ReactNode | null | false | Content to be rendered inside the button. Can be used instead label of to provide more flexibility. Accepts any valid markup. Warning, if Label is set, it will be used instead of child content. |

File Upload Events

| Name | Default | Required | Params | Description | | -------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | | onChange | null | false | 1. Name: files, Type: FileList, Description: The file list of loaded files.,2. Name: event, Type: object, Description: The javascript event. | Fired when file input's value is changed |