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