www.dextsolution.com
DEXTUPLOAD
X5
menu toggleReference > component

getWithCredentials

  • Version 2.2.0.0 or later

  • Explanation

    Returns whether the server can attempt to make a request with credentials such as cookies, authentication headers, and TLS client credentials.

  • Uses

    isWith = component.getWithCredentials();
  • Return

    True if credentials are available, false otherwise.

setWithCredentials

  • Version 2.2.0.0 or later

  • Explanation

    Cookies, authentication headers, TLS client credentials, and whether or not a request can be made to the server.

    To share a domain cookie, you must call the setWithCredentials method with the parameter set to true, as well as the server's CORS settings.

    If set to true, the target server can not specify the value of the Access-Control-Allow-Origin header as '*', but must explicitly record what it allows. You also need to set the Access-Control-Allow-Credentials header to true.

    function onDX5Created(id) {
        var dx = dx5.get()
        // Set to share credentials. 
        dx.setWithCredentials(true);
    }
  • Uses

    component.setWithCredentials(isWith);
  • Parameters

    Name Type Explanation
    isWith String Set true to share credentials in a cross-domain request, false otherwise.

enableResumingUpload

  • Version 1.0.0.0 or later

  • Explanation

    When uploading, set whether or not to use continuation. In the context of uploading files, continuation refers to the option to continue uploading the same file to the server halfway through, even after canceling the upload completely or closing the browser, rather than aborting the upload and retrying it again.

    • Because it only works with chunked file uploads, it only supports 'EXTS' and 'AWSS3' methods.
    • If you clear your browser cache, the file will be uploaded from the beginning, even if it's in a consecutive state.
    • Amazon S3 only allows you to keep your files for up to 7 days.
    function onDX5Created(id) {
      var dx = dx5.get(id);
      // Use the large file upload. 
      dx.setUploadMode("EXTS");
      // Set the upload block unit to 10MB.
      dx.setUploadBlockSize(10 * 1024 * 1024);
      // Do not use resume-upload. 
      dx.enableResumingUpload(false);
    }
  • Uses

    component.enableResumingUpload(enable);
  • Parameters

    Name Type Explanation
    enable Boolean If true, use resume-upload. The default value is true.

isUsingProgressDialog

  • Version 1.0.0.0 or later

  • Explanation

    Returns whether to use the product's own progress window.

    You can use the useProgressDialog function to disable the default progress window in DEXTUploadX5.

    Instead, the getUploadStatus function can be used to get upload progress information in a script.

    // Do not use the default progress window. 
    dx.useProgressDialog(false);
    // Because the progress window is not visible, use getUploadStatus function to get upload progress information.
    var status = dx.getUploadStatus();
    // Name: status.currentName 
    // Total speed: status.totalSpeed 
    // Number of uploads completed: status.completeCount
    // Total number: status.totalCount
    // Current file transfer rate: status.currentRate
    // Transferred size of current file: status.currentSendSize
    // Size of the current file: status.currentSize
    // Transfer time of the current file: status.currentTime
    // Time remaining of the current file: status.remainedCurrentTime
    // Total file transfer rate: status.totalRate
    // Size transferred: status.totalSendSize
    // Size of the entire file: status.totalSize
    // Transfer time of the entire file: status.totalTime
    // Remaining time of the entire file: status.remainedTotalTime
    
  • Uses

    using = component.isUsingProgressDialog();
  • Return

    true, false

isWheelEnabled

  • Version 3.1.0.0 or later

  • Explanation

    Returns whether to use the mouse wheel-scrolling.

    The default is true.

  • Uses

    using = component.isWheelEnabled();
  • Return

    true, false

setWheelEnabled

  • Version 3.1.0.0 or later

  • Explanation

    Enable or disable the mouse wheel-scrolling.

    The default is true.

    The mouse wheel-scrolling function is only considered the desktop browser and is not supported in the mobile environment.

    // Disable the mouse wheel-scrolling.
    dx.setWheelEnabled(false);
    
  • Uses

    component.setWheelEnabled(enable);
  • Parameters

    Name Type Explanation
    enable Boolean Whether to use the mouse wheel-scrolling

createColumn

  • Version 3.2.0.0 or later

  • Explanation

    The 'createColumn' method adds a custom column in a'GRID' style component. The 'createColumn' method should be applied prior to the code that adds virtual files.

    var dx = dx5.get(id);
    dx.createColumn({ key: "col01", display: "Column 1" });
    dx.createColumn({ key: "col02", display: "Column 2", width: 150, position: 2, valueAlign: "right" });
    dx.createColumn({
        key: "col03", display: "Column 3", width: 100, type: "list", items: [
            { display: "Banana", value: "A" },
            { display: "Apple", value: "B" },
            { display: "Melon", value: "C" },
            { display: "Kiwi", value: "D" },
            { display: "Grape", value: "E" }
        ]
    });
    // The 'creatColumn' method should be called before the 'dx.addVirtualFile' and 'dx.addVirtualFileList' methods.
    

    Custom columns can be expressed at a simple level of HTML, so you can display an image such as an icon as the column value or use a button.

    dx.createColumn({
        key: "grade", display: "Grade", width: 80, itemAlign: "left", type: "list", items: [
            { display: "<img src='http://.../class_a.gif' /><span>A Grade</span>", value: "A" },
            { display: "<img src='http://.../class_b.gif' /><span>B Grade</span>", value: "B" },
            { display: "<img src='http://.../class_c.gif' /><span>C Grade</span>", value: "C" },
            { display: "<img src='http://.../class_d.gif' /><span>D Grade</span>", value: "D" },
            { display: "<img src='http://.../class_e.gif' /><span>E Grade</span>", value: "E" },
            { display: "<img src='http://.../class_f.gif' /><span>F Grade</span>", value: "F" },
            { display: "<img src='http://.../class_g.gif' /><span>G Grade</span>", value: "G" },
            { display: "<img src='http://.../class_h.gif' /><span>H Grade</span>", value: "H" },
            { display: "<img src='http://.../class_i.gif' /><span>I Grade</span>", value: "I" },
            { display: "<img src='http://.../class_j.gif' /><span>J Grade</span>", value: "J" }
        ]
    });
  • Uses

    component.createColumn({ /* option */ });
  • Parameters

    Name Type Explanation
    key String

    This is the name of the custom column and the name of the meta-data. The key is used as the name of the meta-data, so only English and numeric combinations can be used.

    The name 'name, size, op' cannot be used.

    dispaly String

    This is the header name of the custom column.

    width Number

    The width of the custom column. The default is 50px.

    type String

    As a way to define custom columns, you can select two methods,'text' and'list'.

    items Array

    Indicates items to be used when the custom column type is 'list'. The'list' type does not express the same effect as a drop-down list on the component screen, but only provides a function of selecting the matching item for the actual value.

    Set the items property in the following way.

    dx.createColumn({
        key: "columnKey", display: "Column Name", width: 150, type: "list", items: [
            { display: "Banana", value: "A" },
            { display: "Apple", value: "B" },
            { display: "Melon", value: "C" },
            { display: "Kiwi", value: "D" },
            { display: "Grape", value: "E" }
        ]
    }); 
    
    position Number

    Indicates the location where custom columns are added, starting from 2.

    headerAlign String

    This indicates the horizontal alignment ('left','center','right') of the header name. The default is'center'.

    itemAlign String

    This indicates the horizontal alignment ('left','center','right') of the content of the item. The default is'center'.

deleteColumn

  • Version 3.2.0.0 or later

  • Explanation

    The deleteColumn method deletes the custom column from the 'GRID' style component.

    var dx = dx5.get(id);
    dx.deleteColumn("col1");
    dx.deleteColumn("col2");
    dx.deleteColumn("col3");
    
  • Uses

    component.deleteColumn(key);
  • Parameters

    Name Type Explanation
    key String

    This is the name of the custom column and the name of the meta-data. The key is used as the name of the meta-data, so only English and numeric combinations can be used.

    The name 'name, size, op' cannot be used.

setColumnVisible

  • Version 3.2.1.0 or later

  • Explanation

    Shows and hides a specific column in the 'GRID' style component.

    var dx = dx5.get(id);
    ...
    // Hides the "size" column.
    dx.setColumnVisible("size", false);
    // Show the "size" column.
    dx.setColumnVisible("size", true);
    
  • Uses

    component.setColumnVisible(key, visible);
  • Parameters

    Name Type Explanation
    key String

    The column's name(=key) to be shown or hidden

    The name of the size column is 'size' and the name of state column is 'op'.

    The 'setColumnVisible' method can't be applied to the filename column.

    visible Boolean

    True to show a column, false otherwise.

setEnableDeletionByKey

  • Version 3.3.0.0 or later

  • Explanation

    You can turn on/off the ability to delete items with the keyboard.

    // Set the keyboard to prevent deletion of items.
    dx.setEnableDeletionByKey(false);
    
  • Uses

    component.setEnableDeletionByKey(byKey);
  • Parameters

    Name Type Explanation
    byKey Boolean

    If set to false, items cannot be deleted using the keyboard. The default is true.

setUploadByOrder

  • Version 3.3.0.0 or later

  • Explanation

    When uploading, you can set the items arranged on the screen to be uploaded in order. If you don't use the setUploadByOrder method, uploading proceeds in the order in which files were added.

    // Set to upload items in sort order.
    dx.setUploadByOrder(true);
    
  • Uses

    component.setUploadByOrder(byOrder);
  • Parameters

    Name Type Explanation
    byOrder Boolean

    If set to true, uploads are performed in sort order. The default is false.

isChecksumEnable

  • Version 3.4.0.0 or later

  • Explanation

    Returns whether a hash is generated for integrity check.

  • Uses

    useChecksum = component.isChecksumEnable();
  • Return

    Whether to generate hashes, default is false

setChecksumEnable

  • Version 3.4.0.0 or later

  • Explanation

    Set whether to generate hashes for integrity check. If set to true, the file's hashes are transmitted to the server when the file is uploaded, so the server can perform integrity check by comparing it with the hash information.

    Since DEXTUploadX5 alone cannot perform integrity check, DEXTUploadNJ version 2.6.0 must be used as a server component. And this function only applies to the extension-upload (when the upload mode is 'EXTS').

    // Turn on the generating hash.
    dx.setChecksumEnable(true);
    
  • Uses

    component.setChecksumEnable(enable);
  • Parameters

    Name Type Explanation
    enable Boolean Whether to generate hashes

setCustomFilter

  • Version 3.5.0.0 or later

  • Explanation

    Sets up a custom filter function.

    Custom filter is a function that allows the user to define a function that can limit file items without using the function provided by the product.

    /**
     * Rejects if the file name exceeds 10 digits excluding the extension name of it.
     * @param file the File(Blob) object
     * @return If true, allow, false if deny.
     */		
    function rejectFilesWithLongName(file) {
        if (file.name.length > 10) return false;
        else return true;
    }
    
    function onDX5Created(id) {
        var dx = dx5.get(id);
        ...
        // Registers the custom filter function.
        dx.setCustomFilter(rejectFilesWithLongName);
    }
    
  • Uses

    component.setCustomFilter(filter);
  • Parameters

    Name Type Explanation
    filter Function The custom filter function that returns a boolean value