beforeUploadFile

2.2.0 버전부터 지원합니다.

파일이 업로드되기 전에 발생합니다. 이벤트 진행을 취소할 수 있습니다.

이벤트 등록: API 사용

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';
var editor = new SynapEditor(editorId, editorConfig, html);

editor.setEventListener('beforeUploadFile', function (e) {
});

이벤트 등록: 함수 방식

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';

function SynapEditorBeforeUploadFile(e) {
}

new SynapEditor(editorId, editorConfig, html);

이벤트 등록: 에디터 초기화 시 등록

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';
var eventListeners = {
    beforeUploadFile: function (e) {
    }
};

new SynapEditor(editorId, editorConfig, html, eventListeners);

함수에 전달된 객체의 Shape

함수에 전달되는 매개변수 e의 형태는 다음과 같습니다.

// release 2.2.0
e = {
    editor: SynapEditor,
    eventType: 'beforeUploadFile',
    cancelable: true,
    returnValue: null,
    fileName: 'filename.zip'    // Name of the file being uploaded
}

// release 2.2.1 and above
e = {
    editor: SynapEditor,
    eventType: 'beforeUploadFile',
    cancelable: true,
    returnValue: null,
    fileType: 'file',           // [2.2.1] File type
    fileName: 'filename.zip',
    uploadCount: 0              // [2.2.1] Number of files being uploaded (number of pending upload targets)
}

// release 2.14.6 and above
e = {
    editor: SynapEditor,
    eventType: 'beforeUploadFile',
    cancelable: true,
    returnValue: null,
    fileType: 'file',
    fileName: 'filename.zip',
    fileSize: 100,              // [2.14.6] File size (unit: Byte)
    uploadCount: 0
}

API

event.setApi(api)

2.7.0 버전부터 지원합니다.

이벤트 객체를 통해 업로드 API를 설정할 수 있습니다.

{
    beforeUploadFile: function (e) {
        e.setApi('newUploadURL');
    }
}

event.setFileFieldName(fileFieldName)

2.7.0 버전부터 지원합니다.

이벤트 객체를 통해 폼 데이터의 fieldName을 설정할 수 있습니다. (기본값: 'file')

{
    beforeUploadFile: function (e) {
        e.setFileFieldName('file');
    }
}

event.addHeader(key, value)

2.7.0 버전부터 지원합니다.

이벤트 객체를 통해 요청 헤더를 설정할 수 있습니다.

{
    beforeUploadFile: function (e) {
        e.addHeader('X-Hello', 'World');
    }
}

event.addParameter(key, value)

2.7.0 버전부터 지원합니다.

이벤트 객체를 통해 매개변수를 설정할 수 있습니다.

{
    beforeUploadFile: function (e) {
        e.addParameter('hello', 'world');
    }
}