A handy control for quick and easy uploading of a file or a set of files.

SimpleVault control

Related sample:  Simple vault - DHTMLX Form

Related sample:  All dhxForm inputs - DHTMLX Form

Adding SimpleVault

You can easily add a SimpleVault control during initialization of a form:

var form = new dhx.Form("form_container", {
    rows: [
            type: "simpleVault",
            label: "files",
            labelInline: true,
            labelWidth: "50px",


You can provide the following attributes in the configuration object of a SimpleVault:

  • type - (string) the type of a control, set it to "simpleVault"
  • id - (string) the id of a control, auto-generated if not set

  • parent - (string) the id of the parent control
  • width - (string) the width of a control
  • height - (string) the height of a control
  • css - (string) adds style classes to a control
  • disabled - (boolean) defines whether a control is enabled (false) or disabled (true)
  • label - (string) specifies a label for a control
  • labelWidth - (string) sets the width of the label of a control
  • hiddenLabel - (boolean) invisible label that will be used to identify the input on the server side
  • labelInline - (boolean) defines the position of a label: true - to set a label inline with a control
  • name - (string) the name of a control
  • required - (boolean) defines whether a control is required
  • help - (string) adds a help message to a control
  • preMessage - (string) a message that contains instructions for interacting with the control
  • successMessage - (string) a message that appears in case of successful validation of the control value
  • errorMessage - (string) a message that appears in case of error during validation of the control value
  • gravity - (boolean) arranges form controls evenly throughout the container, depending on the direction of layout ("cols" or "rows"), true by default

  • autosend - (boolean) enables/disables automatic sending of an added file
  • fieldName - (string) sets the file field name in the form data that is sent to the server
  • params - (object) adds extra parameters for sending an XMLHttpRequest
  • singleRequest - (boolean) defines whether files are sent in one request
  • target - (string) sets an URL to the server-side script that will process file upload
  • updateFromResponse - (boolean) updates file attributes with data from server response
Back to top