AJAX
ss:ajax:delayedload ss:ajax:event ss:ajax:region
Data
ss:data:calendar ss:data:column ss:data:postrepeater ss:data:productbrandrepeater ss:data:productcategoryrepeater ss:data:productrepeater ss:data:repeater ss:data:table ss:data:template ss:data:tree
Forms
ss:forms:address ss:forms:captcha ss:forms:checkbox ss:forms:checkboxgroup ss:forms:codeeditor ss:forms:combobox ss:forms:datepicker ss:forms:dialogbox ss:forms:editbox ss:forms:fileupload ss:forms:form ss:forms:hidden ss:forms:money ss:forms:officeuseregion ss:forms:option ss:forms:password ss:forms:paymentmethod ss:forms:radiobutton ss:forms:radiobuttongroup ss:forms:row ss:forms:searchbox ss:forms:signature ss:forms:slider ss:forms:spinbox ss:forms:submitbutton ss:forms:submitimage ss:forms:submitlink ss:forms:successcontent ss:forms:textarea ss:forms:timepicker
Layout
ss:layout:gallery ss:layout:productgallery ss:layout:rotator ss:layout:stepper ss:layout:stepperpanel ss:layout:tablist ss:layout:tablistitem
Logic
ss:logic:dependency ss:logic:parse ss:logic:if ss:logic:else ss:logic:include ss:logic:variable
Navigation
ss:navigation:breadcrumbs ss:navigation:item ss:navigation:primary ss:navigation:secondary
Standard
ss:standard:audio ss:standard:embed ss:standard:icon ss:standard:image ss:standard:link ss:standard:script ss:standard:video
Templates
ss:templates:button ss:templates:card ss:templates:column ss:templates:fancybox ss:templates:faq ss:templates:flexlayout ss:templates:header ss:templates:row ss:templates:section ss:templates:teammember ss:templates:testimonial
Regions
ss:regions:content ss:regions:contentadditional ss:regions:security ss:regions:togglable
Third Party
ss:thirdparty:googlemap ss:thirdparty:googlemapmarker
Attributes
Examples

<ss:forms:fileupload />

Allows the user to upload a file.

Attributes

buttonIcon
string
The name or path for an icon to be used on the upload button.
Supported names are "Upload", "Attachment", "Photo". Any other value will be interpreted as a path.
buttonText
string
The text to display inside the browse button. This text is rendered as HTML and may contain tags or HTML entities.
dataColumn
Sets the data column

The datacolumn links the form item to a key used when getting or saving from a component (as defined by the parent form).
disabled
bool
Disable Input

Disables the input, preventing user interaction
extensions
string
Defines a whitelist for acceptable file extensions. This can be a key word reference to one of the standard provided lists, or as a list of '.' prefixed extensions in lower case.
Whitespaces are ignored in all cases.
Use "ALL" to disable whitelisting.

Whitelist keywords: "MEDIA" - Default. All extensions from "DOC", "IMAGE", "VIDEO" and "AUDIO". "DOC" - Common extensions such as '', 'txt', 'pdf' and 'doc'. "IMAGE" - Common extensions such as 'gif', 'jpg', 'jpeg' and 'png'. "VIDEO" - Common extensions such as 'mp4', 'avi' and 'webm'. "AUDIO" - Common extensions such as 'wav' and 'mp3'. "ALL" - No whitelist will be applied.

Example non keyworded whitelist: extensions="" - No extensions will match this list. Use "ALL" if no whitelist is desired. extensions="." - Only files ending in no extension. extensions=".csv.zip" - Only files ending in or '.csv', or '.zip'. extensions=".csv.zip." - Only files ending in no extension, '.csv', or '.zip'.
fileCountLimit
string
The maximum number of files allowed to be uploaded.
Set this option to "none" for no limit. This is the default.
fileSizeLimit
string
The maximum individual file size allowed.

If a number by itself is supplied, the value will be in bytes.
A number followed by either KB, MB, or GB can be specified to specify the unit.
Set this option to "none" for no limit. This is the default.
focusOnLoad
bool
Focus On Load

If true, this control will attempt to focus itself after the page has loaded. Note that only one element may be focused on the page at a time.
Default = false
height
string
Height

Sets the height of the element. The default units are pixels. include the percentage symbol % to user percentage values.
id
string
(Required) Most form items need a unique id so that they can submit data to the server. No two form items may have the same id. For situations where multiple form items submit to the same field, see the name attribute. Id's that begin with contact_ will automatically save Contact information to the Contact database as long as the user has entered enough identifying information (ideally Name and Email). Check the Contact Fields page for correct field names.
multipleUpload
boolean
Enables multiple upload. Defaults false.
name
string
Sets the name of the form item. Most of the time, the id attribute will suffice. However with form items that post multiple values into an array, each item will need to have the same name, followed by []. For example three controls with name="data[]", will all post into 'data'.
Radio buttons belonging to the same group will have to share the same name.
onQueueComplete
string
A JavaScript callback triggered when all uploads have completed. _arrFileUploadSuccessFiles: {Array{ complete: {Boolean}, name: string, arrFileNames: {Array{String}}, // The file names as they have been stored in the // filesystem. type: string, size: int, uploading: {Boolean} }}
saveState
bool
Restore state on reload

Whether or not the value of the input is persists when the page is revisited.
Default = false
tinyMode
bool
If set to true, a simple input type="file" will be used.
totalSizeLimit
string
The maximum individual file size allowed.

If a number by itself is supplied, the value will be in bytes.
A number followed by either KB, MB, or GB can be specified to specify the unit.
Set this option to "none" for no limit. This is the default.
transformations
Value Transformations

Sets the value transformations to be applied to the value of the form item as a comma separated string.
validations
Validations

Sets the validations to be applied to the value of the form item as a comma separated string.

Eg: validations="mandatory"
width
string
Width

Sets the width of the element. The default units are pixels. include the percentage symbol % to user percentage values.

Examples

Simple File Upload Example

Describes how to put a file upload element into a form

HTML:

Upload an image to email example

Uses form's onsubmitemail and fileupload's extensions="IMAGE"

HTML: