프로젝트 소개
@egjs/flicking은 NAVER가 유지 관리하는 캐러셀(슬라이더) 컴포넌트 라이브러리로, npm 패키지 모노레포로 배포됩니다. README에서는 안정적이고 유연하며 확장 가능하다고 설명하며, 대규모로 사용되고 있다는 점을 강조합니다.
README에 설명된 핵심 기능:
- SSR 지원: Next.js 및 Nuxt에서 작동합니다.
- 순환 모드: 끊김 없는 무한 루프를 지원합니다.
- 자유 스크롤: 모멘텀 기반의 네이티브 스크롤 경험을 제공합니다.
- 가상 스크롤: 대규모 데이터셋에서 보이는 패널만 렌더링합니다.
- 플러그인: @egjs/flicking-plugins를 통한 AutoPlay, Fade, Parallax, Arrow, Pagination을 지원합니다.
- TypeScript: 완전한 타입이 적용된 API를 제공합니다.
저장소의 패키지:
- @egjs/flicking — 핵심 캐러셀 라이브러리.
- @egjs/flicking-plugins — 캐러셀용 기성 효과 모음.
- @egjs/react-flicking — React 포트.
- @egjs/vue3-flicking — Vue 3 포트.
npm(npm install --save @egjs/flicking) 또는 CDN(jsDelivr, unpkg, cdnjs)을 통해 설치할 수 있습니다. 빠른 시작에서는 뷰포트 요소 안에 카메라 요소와 패널 자식 요소를 포함하는 최소 HTML 구조를 보여 주며, ES 모듈 또는 패키지 CDN 스크립트를 통해 초기화합니다. 예: new Flicking("#my-flicking", { circular: true }).
지원 브라우저는 최신 Chrome, Firefox, Safari와 iOS 7 이상, Android 4 이상으로 나열되어 있습니다.
README에서는 "AI Native" 방향도 언급합니다. 사용 사례 중심의 문서화, 더 강력한 TypeScript 타입, 더 명확한 오류 메시지, 예측 가능한 내부 구조, 그리고 LLM과 AI 에이전트에 문서를 제공하기 위한 llms.txt 가이드를 포함합니다.
문서에는 임베디드 라이브 코드 편집기가 포함된 데모, 빠른 시작 가이드, API 레퍼런스가 포함되어 있습니다. 이 프로젝트는 MIT 라이선스(Copyright 2015-present NAVER Corp.)로 제공되며 GitHub 이슈와 CONTRIBUTING.md를 통해 기여를 받습니다.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.