1.0.0.0 이상

설명

onDX5Created 함수는 컴포넌트가 생성되면 호출되는 콜백 함수이다.

DEXTUploadX5는 DOM의 onload 이벤트를 가지고 생성 주기를 판단할 수 없으므로, 컴포넌트가 생성되었을 때 onDX5Created 콜백 함수를 호출하도록 되어 있다.

function onDX5Created(id) {
    // 업로드 경로 설정
    // 스타일 설정
    // 가상 파일 등록
}

형식

# 전역으로 이벤트 핸들러 선언 
function onDX5Created(id) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        created: function(id) { ... }
    }
});

파라미터

1.0.0.0 이상

설명

onDX5Error 함수는 컴포넌트 내부에서 오류가 발생하면 호출되는 콜백 함수이다.

HTTP는 GET, POST 요청(파일 업로드도 마찬가지)을 했을 때 서버에서 문제없이 코드가 완료가 되었다면 HTTP 상태 코드값 200이 반환된다. DEXTUploadX5는 서버로부터 200 코드값을 받으면, 파일 업로드가 완료되었음을 알게 되며, 이때 onDX5UploadCompleted 콜백 함수를 호출한다. 이와 반면에 서버에서 400, 403, 404, 500과 같은 HTTP 상태코드를 받는 다면, 오류가 발생한 것으로 판단하고 추가 작업을 중지하며, onDX5Error 콜백 함수를 호출한다. 그러므로 서버 측 코드에서는 오류가 발생했을 때, 이를 무시하거나, 다른 형식으로 포장해서는 안되며, Exception이 발생하는 경우 500 오류가 전달이 되도록 조치를 해야 한다. 만일 try - catch 구문처럼 서버에서 오류를 캐치하고, 오류를 전달하지 않으면 서버는 200 값을 반환하게 되므로, DEXTUploadX5는 업로드가 성공적으로 완료된 것으로 판단하게 된다. 또한 서버에서 오류가 발생했을 때, 에러 페이지를 예쁘게 꾸며 클라이언트로 전달하는 경우가 많은데, 이때 클라이언트로 전달되는 메시지는 오류 내용이지만, 상태 코드가 200이므로 DEXTUploadX5는 업로드가 성공적으로 완료된 것으로 판단하게 된다.

function onDX5Error(id, code, message) {
    alert(code + "\n" + message);
}

만약 onDX5Error 함수가 페이지 내에 없다면, 발생된 오류를 확인할 방법이 없다. DEXTUploadX5는 onDX5Error 함수 외에 오류를 따로 기록하는 로깅 기능은 없다.

형식

# 전역으로 이벤트 핸들러 선언
function onDX5Error(id, code, message) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        error: function(id, code, message) { ... }
    }
});

파라미터

1.0.0.0 이상

설명

onDX5ItemDoubleClick 함수는 마우스를 사용하여 항목을 더블 클릭을 하면 호출되는 콜백 함수이다.

function onDX5ItemDoubleClick(id, itemIndex, itemId, itemType) {
    ...
}

형식

# 전역으로 이벤트 핸들러 선언
function onDX5ItemDoubleClick(id, itemIndex, itemId, itemType) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        itemDoubleClick: function(id, itemIndex, itemId, itemType) { ... }
    }
});

파라미터

1.0.0.0 이상

설명

onDX5ItemSelect 함수는 항목이 선택 상태가 되면 호출되는 콜백 함수이다.

선택 이벤트는 마우스 클릭 또는 키보드 이동 과정에 발생한다.

function onDX5ItemSelect(id, itemIndex, itemId, itemType) {
    ...
}

형식

# 전역으로 이벤트 핸들러 선언 
function onDX5ItemSelect(id, itemIndex, itemId, itemType) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        itemSelect: function(id, itemIndex, itemId, itemType) { ... }
    }
});

파라미터

1.0.0.0 이상

설명

onDX5ItemCheck 함수는 항목을 체크하거나 체크 해제를 하면 호출되는 콜백 함수이다.

function onDX5ItemCheck(id, count) {
    ...
}

형식

# 전역으로 이벤트 핸들러 선언 
function onDX5ItemCheck(id, count) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        itemCheck: function(id, count) { ... }
    }
});

파라미터

1.0.0.0 이상

설명

onDX5Preview 함수는 미리보기가 이벤트 방식으로 설정되면 호출되는 콜백함수이다.

function onDX5Preview(id, itemIndex, itemId, itemSource) {
    target.src = itemSource;
}

형식

# 전역으로 이벤트 핸들러 선언
function onDX5Preview(id, itemIndex, itemId, itemSource) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        preview: function(id, itemIndex, itemId, itemSource) { ... }
    }
});

파라미터

3.6.0.0 이상

설명

onDX5ItemsToHDFinish는 다운로드할 항목들이 HD 응용프로그램으로 모두 전달되었을 때 호출되는 콜백 함수이다.

function onDX5ItemsToHDFinish(id, arr) {
    console.log("Transferring items was finished");
}

HD 응용프로그램은 onDX5ItemsToHDFinish 이벤트가 호출되기 전에 이미 다운로드 작업을 시작한다.

형식

# 전역으로 이벤트 핸들러 선언
function onDX5ItemsToHDFinish(id, arr) { ... }

# 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
dx5.create({
    ...
    events: {
        itemsToHDFinish: function(id, arr) { ... }
    }
});

파라미터