프로젝트 소개
Dropzone은 모든 HTML 요소를 드롭존으로 바꿔주는 JavaScript 라이브러리입니다. 사용자는 파일을 해당 요소에 드래그 앤 드롭할 수 있으며, 라이브러리는 XHR을 통한 업로드를 처리하면서 파일 미리보기와 업로드 진행률을 표시합니다. TypeScript로 작성되었으며 자체 타입 정의를 포함하므로 별도의 @types 패키지가 필요하지 않습니다. README에는 이전 @types/dropzone이 5.7.9에서 중단되었고 v5 API를 설명하므로, 존재한다면 제거해야 한다고 명시되어 있습니다.
설치는 npm(npm install dropzone) 또는 pnpm을 통해 이루어지며, ES6 모듈 또는 CommonJS 모듈로 사용할 수 있습니다. 패키지 매니저나 번들러가 없는 프로젝트를 위해 unpkg에서 독립 실행형 파일을 제공하며, 스타일시트와 함께 Dropzone을 전역 변수로 노출합니다.
문서화된 기능은 다음과 같습니다: 매력적인 기본 스타일링; thumbnail(file, data) 콜백을 통한 이미지 썸네일 미리보기; 고DPI 화면 지원; 여러 파일 및 동기 업로드; 진행률 업데이트; 청크 업로드를 통한 대용량 파일 지원; Amazon S3 Multipart 업로드 지원; 기본 이벤트 리스너를 덮어써서 완전한 테마 변경; 업로드 전 브라우저 측 이미지 리사이징. README는 이 라이브러리가 잘 테스트되었다고 밝힙니다.
저장소는 npm에 dropzone(packages/dropzone)으로 게시된 라이브러리, Docusaurus로 구축된 문서(apps/docs), SvelteKit으로 구축된 웹사이트(apps/website)를 포함하는 모노레포입니다. 개발 명령어로는 pnpm install, pnpm build, pnpm test, pnpm test:e2e, pnpm dev:docs, pnpm dev:website가 있습니다. 단일 명령어인 pnpm build:site는 루트의 웹사이트와 /docs 아래의 문서를 결합하여 _site/에 배포 가능한 GitHub Pages 사이트를 생성하며, CI도 동일한 스크립트를 실행합니다.
Dropzone 6은 Internet Explorer를 지원하지 않습니다. 해당 브라우저가 필요하다면 버전 5.9.3이 권장됩니다. 커뮤니티 지원은 버그 신고 전용인 이슈 트래커 대신 GitHub Discussions 또는 dropzone.js 태그를 사용한 Stack Overflow로 안내됩니다. 이 프로젝트는 MIT 라이선스입니다.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.