Upload files into your S3 bucket with the S3 uploader component. This component lets you build tools that can upload files.
Ways to use a S3 uploader
Upload images to be displayed
If you're uploading images, you can bind an image component to your s3 bucket to display what is being uploaded.
You’re building a tool to manage the promotional banner displayed in your app. You add an S3 uploader that will allow the user to upload new banner images. Then, you bind an image component to the S3 bucket, so that the user can preview the image they just uploaded.
Store docs and other files
Build tools for storing all types of files.
You need a tool to store scanned employee documents for HR records. You can use an s3 uploader here and then bind a table to the s3 bucket so that users can browse through uploaded files.
Configuring your s3 uploader
Simply select the S3 bucket that you want your files to be uploaded to (after you've connected s3).
You can customize the button text and add an optional icon.
You can create visibility rules that will determine when this component is visible and able to be interacted with.
This effect allows you to define the text of messages for success and failure of submission of the data from the component.
Additionally, only one message is allowed to be configured per function success and one for failure.
Usually, if your import changes some data that is displayed in the Space, you'll want to refresh the data. On Submit: Refresh Component options allow you to refresh the data of any component in the Space. Simply select the component to refresh from the dropdown. When the submission from your button is successfully complete, the selected component will refresh and display any changes to its data.
Auto Update by Key
This is the default state for "Effects" for this component. When the component submits its data successfully, components that are bound to that function will automatically be updated by key (e.g. Sending an email-address update to a user's table should result in the updating of associated row table data associated with that key.)
Left and Top options only appear for top-level components (components that are placed directly onto the Space canvas).
Left: Set the distance of this component from the left edge of the Space canvas (x-axis position). This can be expressed as a % of the canvas or as a number of pixels.
Top: Set the distance of this component from the top edge of the Space canvas (y-axis position). This can be expressed as a % of the canvas or as a number of pixels.
Width: Set the width of this component as a number of pixels or as a % of the containing unit.
Height: Set the height of this component as a number of pixels or as a % of the containing unit.
If the component is a top-level component, the containing unit is the Space canvas.
If the component is in-line within another component, the containing unit is the parent component.
If the component is within a flexbox component, the containing unit is the flexbox.
Snap to Grid: Set the edges of this component to snap to the grid canvas in the Space.