The SendSafely Dropzone allows end users to upload end-to-end encrypted files and secure messages to a given set of recipients
Return Type:
Constructor
The only constructor for the library.
|
|||||||||||||||
Parameters:
|
|||||||||||||||
Raised Events: N/A
|
Return Type:
void
Initialize the Dropzone. Calling the initialize function will create and inject a new Dropzone into the domElements specified in the constructor.
|
Parameters: N/A
|
Raised Events: N/A
|
Return Type:
void
Asynchronous function to manually finalize a package once all files have been uploaded. Only call this function when the disableAutoSubmit flag has been manually set.
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Return Type:
void
Callback function invoked for information about ongoing uploads
|
|||||||||
Parameters:
|
|||||||||
Raised Events: N/A
|
Return Type:
void
Allows setting custom callback function that executes for each file successfully uploaded.
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Return Type:
void
Allows setting custom callback function that executes for each file removed.
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Return Type:
boolean
Checks that the script can run in the end user's browser. Should return true for any modern browser.
|
Parameters: N/A
|
Raised Events: N/A
|
Return Type:
void
Sends a command to set an unconfirmed sender's information.
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Return Type:
void
Sets the label for the Dropzone package
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Return Type:
void
Sends a command to set a package's message
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Return Type:
void
Checks for ongoing uploads across all iframes, triggering a callback with the results
|
||||||
Parameters:
|
||||||
Raised Events: N/A
|
Name | Type | Description |
---|---|---|
url | The URL to which the API will connect. Defaults to https://app.sendsafely.com. Normally, you will only need to change this if your organization instance is hosted outside outside of the US (i.e., https://my-app.sendsafely.co.uk) | |
iframeParentElementIds | An array of ids of the parent elements into which Dropzone iframes will be inserted. No need to read or change. | |
logoPath | The URL to the SendSafely logo that appears in the Dropzone file upload box. | |
disableAutoSubmit | Disable or enable auto submit. If auto submit is enabled, the finalizePackage function will automatically be called when a form on the page is submitted. If disabled, the user will have to call that function manually. | |
hasUploadedFiles | Read-only Boolean that indicates whether files have been uploaded. Defaults to false. | |
packageIsFinalized | Read-only Boolean that indicates whether the Dropzone package has been finalized. Defaults to false. | |
nbrOfFilesAttached | Read-only integer that reflects the number of files uploaded to the Dropzone packages. Defaults to 0. | |
noKeycodeUrl | Variable that stores the link to a Dropzone package that lacks keycodes. Defaults to undefined. | |
unconfirmedSender | The unverified email address of the Dropzone submitter. When logged into the SendSafely web portal and viewing the package, this option will show the unverified email address of the user that submitted the files. | |
packageLabel | The label for the Dropzone package. Typically, the name of the submitter, case ID, ticket number, etc. Defaults to undefined. | |
filePrefix | Property added to the message object created by the iframeOnLoadFuction. Defaults to undefined. | |
invokeDropzoneConnectors | Boolean value that determines whether to invoke a webhook, if this Dropzone uses a webhook for notifications. Defaults to false. | |
ongoingUploads | An array of objects that expose the iframeParentElementId and ongoingUploads properties. Defaults to an empty array. |