www.dextsolution.com
DEXTUPLOAD
X5
menu toggle레퍼런스 > 이벤트

onDX5UploadBegin

  • 1.0.0.0 이상

  • 설명

    onDX5UploadBegin 함수는 업로드가 시작될 때 호출되는 콜백 함수이다.

    function onDX5UploadBegin(id) {
        ...
    }
  • 형식

    # 전역으로 이벤트 핸들러 선언 
    function onDX5UploadBegin(id) { ... }
    
    # 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
    dx5.create({
        ...
        events: {
            uploadBegin: function(id) { ... }
        }
    });
    
  • 파라미터

    이름 형식 설명
    id String 이벤트가 발생한 컴포넌트 아이디

onDX5UploadCompleted

  • 1.0.0.0 이상

  • 설명

    onDX5UploadCompleted 함수는 업로드가 완료될 때 호출되는 콜백 함수이다.

    서버에서 보낸 응답 데이터를 확인하려면 이 함수가 호출된 이후에 확인하면 된다.

    function onDX5UploadCompleted(id) {
        var result = "";
        // ORAF 방식이라면
        result = dx5.get(id).getResponses(0);
        // OROF 또는 EXTS 방식이라면
        result = dx5.get(id).getResponses().join("\n");
        alert("업로드가 완료되었다.\n응답 데이터는 다음과 같는다.\n" + result);
    }
  • 형식

    # 전역으로 이벤트 핸들러 선언
    function onDX5UploadCompleted(id) { ... }
    
    # 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
    dx5.create({
        ...
        events: {
            uploadCompleted: function(id) { ... }
        }
    });
    
  • 파라미터

    이름 형식 설명
    id String 이벤트가 발생한 컴포넌트 아이디
    result (4.0.0.0 이상) Array<{ id: String, response: String }>

    getResponses 메소드를 사용하지 않고 이벤트 콜백 함수의 파라미터로부터 응답 데이터를 바로 얻을 수 있다.

    • id: 업로드된 항목의 id

    • response: 업로드된 항목의 응답 데이터

    ORAF의 경우, result의 길이는 1이며, 요소의 id 속성 값은 빈문자열이다.

onDX5UploadItemEnd

  • 1.0.0.0 이상

  • 설명

    onDX5UploadItemEnd 함수는 개별 파일마다 업로드가 완료될 때 호출되는 콜백 함수이다.

    ORAF 방식으로 업로드를 하면 이 이벤트가 발생하지 않는다.

    function onDX5UploadItemEnd(id, itemId) {
        ...
    }
  • 형식

    # 전역으로 이벤트 핸들러 선언
    function onDX5UploadItemEnd(id, itemId) { ... }
    
    # 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
    dx5.create({
        ...
        events: {
            uploadItemEnd: function(id, itemId) { ... }
        }
    });
    
  • 파라미터

    이름 형식 설명
    id String 이벤트가 발생한 컴포넌트 아이디
    itemId String 항목의 고유 아이디

onDX5UploadItemStart

  • 1.0.0.0 이상

  • 설명

    onDX5UploadItemStart 함수는 개별 파일마다 업로드가 시작될 때 호출되는 콜백 함수이다.

    ORAF 방식으로 업로드를 하면 이 이벤트가 발생하지 않는다.

    function onDX5UploadItemStart(id) {
        ...
    }
  • 형식

    # 전역으로 이벤트 핸들러 선언
    function onDX5UploadItemStart(id, itemId) { ... }
    
    # 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
    dx5.create({
        ...
        events: {
            uploadItemStart: function(id, itemId) { ... }
        }
    });
    
  • 파라미터

    이름 형식 설명
    id String 이벤트가 발생한 컴포넌트 아이디
    itemId String 항목의 고유 아이디

onDX5UploadStopped

  • 1.0.0.0 이상

  • 설명

    onDX5UploadStopped 함수는 업로드가 강제로 중지된 후에 호출되는 콜백 함수이다.

    function onDX5UploadStopped(id) {
        alert("업로드가 중지되었다.");
    }
  • 형식

    # 전역으로 이벤트 핸들러 선언
    function onDX5UploadStopped(id) { ... }
    
    # 컴포넌트 생성 시점에 이벤트 핸들러 등록 (3.10.0.0 버전 이상)
    dx5.create({
        ...
        events: {
            uploadStopped: function(id) { ... }
        }
    });
    
  • 파라미터

    이름 형식 설명
    id String 이벤트가 발생한 컴포넌트 아이디