Skip to main content

File Uploader Widget Overview

The File Uploader Widget provides a drag-and-drop file attachment area in Buildocs UI Engine. Uploaded files are linked to the current form record and can be downloaded, previewed, or deleted directly from the widget. When files are uploaded, an event is sent to the backend.

Behavior​

  • Accepts files via drag-and-drop or a click-to-browse interaction
  • Displays all files currently linked to the form record
  • Each listed file provides actions: Download, Preview, and Delete
  • Large files are uploaded in chunks with a visible progress indicator
  • When upload completes, an onFileUpload event is sent to the backend

Readonly Mode​

When Readonly is enabled:

  • Existing files are listed and available for download and preview
  • The upload area is hidden — no new files can be added
  • Delete actions are disabled

Adding to a Row​

  1. Open your form in the Form Builder
  2. Add a Row to the canvas if one is not already in place — see Building Layouts
  3. Locate the File Uploader widget in the component palette
  4. Drag the widget into an empty Row segment
  5. Open the Properties Panel and set the Name (used as the field name for linking files to this widget)
info

File Uploader widgets must be placed inside a Row segment. They cannot be dropped directly onto the canvas.

Next Steps​

  • Properties — full reference for all file uploader settings
  • File Events — details on the onFileUpload backend event