설명
컴포넌트에 추가할 수 있는 항목은 로컬 파일 및 가상 파일이 있다.
로컬 파일은 파일 다이얼로그를 사용하여 등록된 항목을 말하며, 가상 파일은 addVirtualFile, addVirtualFileList 함수를 사용하여 등록된 가상의 파일을 나타내는 항목을 말한다.
컴포넌트에는 항목에 대한 정보를 얻기 위해서 많은 함수들이 제공된다.
var dx = dx5.get("component-id");
// 모든 항목의 개수를 반환한다.
var countAll = dx.getTotalItemCount();
// 로컬 파일 항목의 개수를 반환한다.
var countLocal = dx.getTotalLocalFileCount();
// 가상 파일 항목의 개수를 반환한다.
var countVirtual = dx.getTotalVirtualFileCount();
// 삭제된 가상 파일 항목의 개수를 반환한다.
var countRemoved = dx.getTotalRemovedFileCount();
특정 항목에 대한 상세 정보를 보기 위해서는 먼저 대상을 얻어야 한다.
getItems, getSelectedItems, getItemById, getItemByIndex 함수를 사용하여 특정 항목 또는 배열을 받아올 수 있다.
var dx = dx5.get("component-id");
// 주어진 아이디 혹은 순서에 해당하는 항목을 반환한다.
var item1 = dx.getItemById("항목 아이디");
var item2 = dx.getItemByIndex(3);
// 전체 항목 배열을 반환한다.
var allItems = dx.getItems();
// 선택된 항목 배열을 반환한다.
var selectedItems = dx.getSelectedItems();
항목은 다음과 같은 속성을 갖는 JSON 객체이다.
- controlId: 항목이 생성된 컴포넌트 아이디
- id: 항목의 고유한 아이디로써 컴포넌트에 의해 결정된다.
- type: 로컬 파일 또는 가상 파일을 구분 짓습니다.
- name: 항목 이름(파일 이름)이다.
- vindex: 가상 파일의 경우 가상 파일을 구분 짓는 키이다. (일반적으로 데이터베이스 키가 사용된다.)
- openUrl: 가상 파일의 경우 파일 열기의 대상이 되는 웹 경로이다.
- downUrl: 가상 파일의 경우 파일 다운로드의 대상이 되는 웹 경로이다.
- size: 파일의 크기(용량)이다.
- checked: 파일의 체크 상태이다.
- lock: 파일의 잠금 상태이다.
- status: 파일의 업로드 상태이다.
반환된 항목은 모두 복제된 객체이므로, 대상 객체의 속성 값을 변경하더라도, 컴포넌트 내부에 영향이 없다.
예제