이벤트 종류

이벤트 이름버전설명

initialized

에디터가 초기화되었을 때 발생합니다

beforeUploadImage

이미지를 업로드 하기 전에 발생합니다
afterUploadImage

이미지 업로드가 완료된 후 발생합니다
beforeUploadVideo

비디오를 업로드 하기 전에 발생합니다
afterUploadVideo

비디오 업로드가 완료된 후 발생합니다
beforeUploadFile

파일을 업로드 하기 전에 발생합니다
afterUploadFile

파일 업로드가 완료된 후 발생합니다
beforeOpenDocument

문서를 열기 전(임포트 전) 발생합니다
afterOpenDocument

문서가 열린 후(임포트 이후) 발생합니다.
beforeNewDocument

새문서를 하기 전 발생합니다.
afterNewDocument

새문서를 한 이후 발생합니다.
onSelection

캐럿 이동 및 셀렉션 확장 등의 셀렉션 동작을 할 때 발생합니다. 
beforeCopy

에디터 편집 영역에서 복사를 했을 복사하기 전에 발생합니다. 이벤트를 통해 복사된 HTML 내용을 확인하거나, 복사될 HTML 설정할 있습니다.

beforePaste

붙여넣기 전에 발생합니다.
afterPaste

붙여넣기 후 발생합니다.
afterEdit

문서를 편집한 이후 발생합니다.


이벤트 등록 

API 사용

editor.setEventListener()

이벤트를 등록 할 때 사용하는 API입니다. 

editor.setEventListener('이벤트이름', function(e) {
});


에디터 초기화시 등록

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';
var eventListeners = {
    '이벤트이름': function (e) {
    }
};

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


함수방식 사용

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

function SynapEditor이벤트이름(e) {
    // 이벤트 이름은 첫자가 대문자
    // ex: initialized => SynapEditorInitialized
    // ex: beforeUploadImage => SynapEditorBeforeUploadImage
}

new SynapEditor(editorId, editorConfig, html);

이벤트 해제

API 사용

editor.removeEventListener()

등록한 이벤트를 제거 할 때 사용하는 API 입니다.

editor.removeEventListener('이벤트이름');


함수로 전달되는 객체 형태

{
	editor: {에디터 객체}, // 에디터
	eventType: 'initialized', // 이벤트 이름
	cancelable: false, // 이벤트 취소 가능 여부
	returnValue: null, // 이벤트 취소 여부
	....  

}


이벤트 진행 취소

cancelable이 true인 경우, returnValue를 false로 설정하면 이벤트 진행을 취소할 수 있습니다.

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';
var eventListeners = {
    'beforeUploadImage': function (e) {
		e.returnValue = false; // 업로드가 더이상 진행되지 않습니다
    }
};

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