2.2.0.0 이상

설명

쿠키, 인증 헤더, TLS 클라이언트 자격 증명과 같은 자격 정보를 가지고 서버로 요청을 시도할 수 있는지 여부를 반환한다.

형식

isWith = component.getWithCredentials();

반환

자격 정보를 사용할 수 있다면 true, 아니면 false이다.

2.2.0.0 이상

설명

쿠키, 인증 헤더, TLS 클라이언트 자격 증명과 같은 자격 정보를 가지고 서버로 요청을 시도할 수 있는지 여부를 설정한다.

도메인 쿠키를 공유하기 위해서는 서버의 CORS 설정 뿐만 아니라, 파라미터를 true로 하는 setWithCredentials 메소드를 호출해야 한다.

true로 설정을 하면, 대상 서버는 Access-Control-Allow-Origin 헤더의 값을 '*'로 지정하지 못하고, 허용하는 대상을 명확하게 기록해야 한다. 또한 Access-Control-Allow-Credentials 헤더를 true로 설정해야 할 필요가 있다.

function onDX5Created(id) {
    var dx = dx5.get()
    // 자격 정보를 공유하도록 설정한다.
    dx.setWithCredentials(true);
}

형식

component.setWithCredentials(isWith);

파라미터

1.0.0.0 이상

설명

업로드할 때, 이어올리기 사용 여부를 설정한다. 파일을 업로드하는 기능에서 이어올리기는 업로드를 중간에 중단하고 다시 재시도하는 기능이 아니라, 업로드를 완전히 취소하거나 브라우저를 닫고 난 후에도 동일한 파일을 중반부터 서버로 올릴 수 있는 옵션을 가리킨다.

• 이어올리기는 파일을 쪼개서 올리는 방식에서만 동작하기 때문에, 'EXTS', 'AWSS3' 방식만 지원한다.
• 브라우저 캐시를 삭제하면 이어올리기 상태라고 하더라도, 처음부터 파일을 업로드한다.
• Amazon S3는 최대 7일 동안만 이어올리기가 가능하다.

function onDX5Created(id) {
  var dx = dx5.get(id);
  // 대용량 업로드 방식으로 사용한다.
  dx.setUploadMode("EXTS");
  // 업로드 블록 단위를 10MB로 설정한다.
  dx.setUploadBlockSize(10 * 1024 * 1024);
  // 이어올리기를 사용하지 않는다.
  dx.enableResumingUpload(false);
}

형식

component.enableResumingUpload(enable);

파라미터

1.0.0.0 이상

설명

제품에서 제공하는 자체 진행창을 사용할지를 반환한다.

DEXTUploadX5에서 기본으로 지원하는 진행창을 사용하지 않으려면 useProgressDialog 함수를 사용할 수 있다.

대신 getUploadStatus 함수를 사용하여 업로드 진행 정보를 스크립트로 따로 얻을 수 있다.

// 기본 진행창을 사용하지 않는다.
dx.useProgressDialog(false);
// 진행창이 안보이므로 getUploadStatus 함수를 사용하여 업로드 진행 정보를 얻는다.
var status = dx.getUploadStatus();
// 이름: status.currentName 
// 전체 속도: status.totalSpeed 
// 업로드가 완료된 개수: status.completeCount
// 전체 개수: status.totalCount
// 현재 파일 전송률: status.currentRate
// 현재 파일의 전송된 크기: status.currentSendSize
// 현재 파일의 크기: status.currentSize
// 현재 파일의 전송 시간: status.currentTime
// 현재 파일의 남은 시간: status.remainedCurrentTime
// 전체 파일 전송률: status.totalRate
// 전체 파일의 전송된 크기: status.totalSendSize
// 전체 파일의 크기: status.totalSize
// 전체 파일의 전송 시간: status.totalTime
// 전체 파일의 남은 시간: status.remainedTotalTime

형식

using = component.isUsingProgressDialog();

반환

제품 자체 진행창 사용 여부

3.1.0.0 이상

설명

마우스 휠 스크롤 사용 여부를 반환한다.

마우스 휠 기능은 기본적으로 활성화되어 있다.

형식

using = component.isWheelEnabled();

반환

휠 스크롤 사용 여부, 기본값은 true

3.1.0.0 이상

설명

마우스 휠 스크롤 사용 여부를 설정한다.

마우스 휠 기능은 기본적으로 활성화되어 있다.

마우스 휠 스크롤 기능은 데스크탑 브라우저만을 고려하며, 모바일 환경에서는 지원하지 않는다.

// 마우스 휠 스크롤 사용 안함.
dx.setWheelEnabled(false);

형식

component.setWheelEnabled(enable);

파라미터

3.2.0.0 이상

설명

createColumn 메소드는 'GRID' 스타일의 컴포넌트에서 사용자 정의 열을 추가한다. createColumn 메소드를 가상 파일을 추가하는 코드보다 우선 적용되어야 한다.

var dx = dx5.get(id);
dx.createColumn({ key: "col01", display: "열1" });
dx.createColumn({ key: "col02", display: "열2", width: 150, position: 2, valueAlign: "right" });
dx.createColumn({
    key: "col03", display: "열3", width: 100, type: "list", items: [
        { display: "Banana", value: "A" },
        { display: "Apple", value: "B" },
        { display: "Melon", value: "C" },
        { display: "Kiwi", value: "D" },
        { display: "Grape", value: "E" }
    ]
});
// dx.addVirtualFile, dx.addVirtualFileList 메소드보다 creatColumn 메소드가 먼저 호출되어야 한다.

사용자 정의 열은 간단한 수준의 HTML 표현이 가능하므로 열의 값으로 아이콘 같은 이미지를 출력하거나 버튼을 사용할 수 있다.

dx.createColumn({
    key: "grade", display: "등급", width: 80, itemAlign: "left", type: "list", items: [
        { display: "<img src='http://.../class_a.gif' /><span>A Grade</span>", value: "A" },
        { display: "<img src='http://.../class_b.gif' /><span>B Grade</span>", value: "B" },
        { display: "<img src='http://.../class_c.gif' /><span>C Grade</span>", value: "C" },
        { display: "<img src='http://.../class_d.gif' /><span>D Grade</span>", value: "D" },
        { display: "<img src='http://.../class_e.gif' /><span>E Grade</span>", value: "E" },
        { display: "<img src='http://.../class_f.gif' /><span>F Grade</span>", value: "F" },
        { display: "<img src='http://.../class_g.gif' /><span>G Grade</span>", value: "G" },
        { display: "<img src='http://.../class_h.gif' /><span>H Grade</span>", value: "H" },
        { display: "<img src='http://.../class_i.gif' /><span>I Grade</span>", value: "I" },
        { display: "<img src='http://.../class_j.gif' /><span>J Grade</span>", value: "J" }
    ]
});

형식

component.createColumn({ /* 생성 옵션 */ });

파라미터

dx.createColumn({
    key: "columnKey", display: "열이름", width: 150, type: "list", items: [
        { display: "Banana", value: "A" },
        { display: "Apple", value: "B" },
        { display: "Melon", value: "C" },
        { display: "Kiwi", value: "D" },
        { display: "Grape", value: "E" }
    ]
}); 

3.2.0.0 이상

설명

deleteColumn 메소드는 'GRID' 스타일의 컴포넌트에서 사용자 정의 열을 삭제한다.

var dx = dx5.get(id);
dx.deleteColumn("col1");
dx.deleteColumn("col2");
dx.deleteColumn("col3");

형식

component.deleteColumn(key);

파라미터

3.2.0.0 이상

설명

'GRID' 스타일의 컴포넌트에서 특정 열을 보여주거나 숨긴다.

var dx = dx5.get(id);
...
// 크기 열을 숨긴다.
dx.setColumnVisible("size", false);
// 크기 열을 보이게 한다.
dx.setColumnVisible("size", true);

형식

component.setColumnVisible(key, visible);

파라미터

3.3.0.0 이상

설명

키보드로 항목을 삭제할 수 있는 기능을 켜고 끌 수 있다.

// 키보드로 항목을 삭제하지 못하도록 설정한다.
dx.setEnableDeletionByKey(false);

형식

component.setEnableDeletionByKey(byKey);

파라미터

3.3.0.0 이상

설명

업로드를 할 때, 화면에 정렬된 항목을 순서대로 업로드할 수 있도록 설정할 수 있다. setUploadByOrder 메소드를 사용하지 않으면, 파일이 추가된 순서대로 업로드가 진행된다.

// 정렬 순서대로 항목을 업로드하도록 설정한다.
dx.setUploadByOrder(true);

형식

component.setUploadByOrder(byOrder);

파라미터

3.4.0.0 이상

설명

무결성 검사를 위한 해시 생성 여부를 반환한다.

형식

useChecksum = component.isChecksumEnable();

반환

해시 생성 여부, 기본값은 false

3.4.0.0 이상

설명

무결성 검사를 위한 해시 생성 여부를 설정한다. true 값으로 설정하면, 파일을 업로드할 때 파일의 해시 정보를 서버로 함께 전송하므로, 서버는 해시 정보와 비교하여 무결성 검사를 수행할 수 있다.

DEXTUploadX5 단독으로 무결성 검사를 수행할 수 없으므로, DEXTUploadNJ 2.6.0 버전을 서버 컴포넌트로 사용해야 한다. 그리고 해당 기능은 대용량 파일 업로드(업로드가 모드가 EXTS인 경우)에서만 적용된다.

// 무결성 검사를 위한 해시 생성.
dx.setChecksumEnable(true);

형식

component.setChecksumEnable(enable);

파라미터

3.5.0.0 이상

설명

사용자 정의 필터 함수를 설정한다.

사용자 정의 필터는 제품에서 기본적으로 제공하는 기능을 사용하지 않고 파일 항목을 제한할 수 있는 함수를 사용자가 직접 정의할 수 있도록 하는 기능이다.

/**
 * 파일의 이름(확장자 제외)이 10자리가 넘는 경우 등록을 허용하지 않는 사용자 정의 필터 함수이다.
 * @param file 컴포넌트에 등록하려는 File(Blob) 객체
 * @return true면 허용, false면 거부
 */	
function rejectFilesWithLongName(file) {
    if (file.name.length > 10) return false;
    else return true;
}

function onDX5Created(id) {
    var dx = dx5.get(id);
    ...
    // 사용자 정의 필터 함수를 등록한다.
    dx.setCustomFilter(rejectFilesWithLongName);
}

형식

component.setCustomFilter(filter);

파라미터