[javascript] PhotoSwipe와 연동하여 이미지 서클코드 생성하기

22 Nov 2023

javascript

PhotoSwipe는 모바일 및 데스크탑에서 사용할 수 있는 자바스크립트 기반의 이미지 갤러리 라이브러리입니다. 이 라이브러리를 사용하면 이미지를 터치하거나 클릭하여 확대, 축소 및 슬라이드 기능을 사용할 수 있습니다.

이 문서에서는 PhotoSwipe를 사용하여 이미지를 순환하여 보여주는 기능을 구현하는 방법에 대해 알아보겠습니다.

PhotoSwipe 설치하기

먼저, PhotoSwipe를 설치해야 합니다. 설치 방법은 여러 가지가 있지만, 이 예시에서는 npm 패키지 매니저를 사용하여 설치하도록 하겠습니다. 다음 명령어를 사용하여 설치합니다.

npm install photoswipe

HTML 구조 설정하기

다음으로, 이미지 서클을 만들기 위한 HTML 구조를 설정해야 합니다. 기본적인 구조는 다음과 같습니다.

<div id="gallery" class="pswp" tabindex="-1" role="dialog" aria-hidden="true">
    <div class="pswp__bg"></div>
    <div class="pswp__scroll-wrap">
        <div class="pswp__container">
            <div class="pswp__item"></div>
            <div class="pswp__item"></div>
            <!-- ... -->
        </div>
        <div class="pswp__ui pswp__ui--hidden">
            <div class="pswp__top-bar">
                <div class="pswp__counter"></div>
                <button class="pswp__button pswp__button--close" title="Close (Esc)"></button>
                <button class="pswp__button pswp__button--share" title="Share"></button>
                <button class="pswp__button pswp__button--fs" title="Toggle fullscreen"></button>
                <button class="pswp__button pswp__button--zoom" title="Zoom in/out"></button>
                <div class="pswp__preloader">
                    <div class="pswp__preloader__icn">
                        <div class="pswp__preloader__cut">
                            <div class="pswp__preloader__donut"></div>
                        </div>
                    </div>
                </div>
            </div>
            <div class="pswp__share-modal pswp__share-modal--hidden pswp__single-tap">
                <div class="pswp__share-tooltip"></div>
            </div>
            <button class="pswp__button pswp__button--arrow--left" title="Previous (arrow left)"></button>
            <button class="pswp__button pswp__button--arrow--right" title="Next (arrow right)"></button>
        </div>
    </div>
</div>

자바스크립트 코드 작성하기

PhotoSwipe를 초기화하고 이미지 서클을 생성하기 위해 자바스크립트 코드를 작성해야 합니다. 다음은 간단한 예시 코드입니다.

// PhotoSwipe 초기화
var gallery = new PhotoSwipe(document.getElementById('gallery'), PhotoSwipeUI_Default, items, options);

// 이미지 서클 생성 및 활성화
gallery.listen('afterChange', function() {
  var currentIndex = gallery.getCurrentIndex();
  
  // 이미지 서클 시작 부분으로 이동
  if (currentIndex === 0) {
    gallery.goTo(gallery.items.length - 1);
  }
  
  // 이미지 서클 끝 부분으로 이동
  if (currentIndex === gallery.items.length - 1) {
    gallery.goTo(0);
  }
});

// PhotoSwipe 열기
gallery.init();

위 코드에서 items는 이미지 항목의 배열이며, options는 PhotoSwipe의 옵션을 설정하는 객체입니다. 필요에 따라 해당 코드를 조정하고, 추가적인 설정을 할 수 있습니다.

결과 확인하기

위의 HTML과 자바스크립트 코드를 적용하여 이미지 서클을 생성할 수 있습니다. 각 이미지는 pswp__item 클래스로 지정되어야 하며, 이미지를 클릭하거나 터치하면 이미지 서클이 작동합니다. 이를 통해 이미지를 연속적으로 탐색할 수 있습니다.

이제 PhotoSwipe와 연동하여 이미지 서클을 생성하기 위한 코드를 작성하는 방법을 알았습니다. PhotoSwipe를 사용하면 간단한 코드로 멋진 이미지 갤러리를 만들 수 있습니다.

PhotoSwipe 설치하기

HTML 구조 설정하기

자바스크립트 코드 작성하기

결과 확인하기

참고 자료