이미지를 업로드 하기 전에 발생합니다. 이벤트 진행 취소가 가능합니다.

이벤트 등록: API 사용

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


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

이벤트 등록: 함수방식

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

function SynapEditorBeforeUploadImage(e) {
}

new SynapEditor(editorId, editorConfig, html);

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

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

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

함수로 전달되는 객체 형태

함수로 전달되는 파라미터 e의 형식

// release 2.2.0
{
	editor: SynapEditor,
	eventType:  'beforeUploadImage',
	cancelable: true,
	returnValue: null,
	fileName: 'filename.png', // 업로드 대상 파일 이름
	isBackground: false // 배경이미지인지 여부
}
 
// release 2.2.1 이상
{
	editor: SynapEditor,
	eventType:  'beforeUploadImage',
	cancelable: true,
	returnValue: null,
	fileType: 'image', // [2.2.1] 파일 타입
	fileName: 'filename.png',
	isBackground: false,
	uploadCount: 0 // [2.2.1] 업로드 중인 파일 수 (아직 업로드 되지 않은 업로드 대상 수)
}

// release 2.14.6 이상
{
	editor: SynapEditor,
	eventType:  'beforeUploadImage',
	cancelable: true,
	returnValue: null,
	fileType: 'image',
	fileName: 'filename.png',
    fileSize: 100, // [2.14.6] 파일 사이즈 (단위: Byte)
	isBackground: false,
	uploadCount: 0 
}

API

event.setApi(api)

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

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

event.setFileFieldName(fileFieldName)

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

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

event.addHeader(key, value)

이벤트 객체를 통해 Request Header를 설정할 수 있습니다.

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

event.addParameter(key, value)

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

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