swiper.js는 슬라이드나 페이지 스와이프 등을 구현하는데 있어 bxslide와 함께 현장에서 많이 사용되는 라이브러리이다.
swiper.js는 오랜 시간 사용이 되던 라이브러리인지라 그동안 많은 업데이트가 되어서, 기존 현장에 적용되어 있는 라이브러리는 구버전인 경우가 많다. 신규 버전을 적용하면 문제가 없을 거라 의문을 가지는 경우도 있지만, 신규 버전은 최신의 사용자 환경에 얼마나 적응을 하였을지 의문이며, 또한 구버전과의 호환성도 고려해야 할 사항이다. 무조건 최신으로 변경할 수 없는 이유이다.
이 글을 작성하는 시점(2025년 3월 11일)에 swiper 최신 버전은 2025년 2월 14일에 배포된 v11.2.4이다. 만약 현장에 적용된 swipe가 이전 버전이라면, 가령 Swiper 3.1.5을 예로 들면 pagination의 옵션으로 fraction이 없다. 이를 간과하고 최신의 옵션을 적용한다면 제대로 구동이 안될 것이다. (Swiper 3.1.5 2015년도 버전이라 너무 예전 버전이 아닌가 싶을 수도 있지만, 10년이 지난 지금도 사용이 되고 있는 곳도 있다.)
과거의 버전을 지금 스와이프 사이트에서는 서비스를 하지 않는다. 물론 관련 옵션도 찾을 수가 없다. 관련 커뮤니티나 블로거가 다룬 적이 있고, 그 게시물을 검색하여 발견한다면 정보를 얻을 수도 있겠다. 그렇지 않다면 라이브러리를 직접 열어 코드를 분석해볼 수도 있겠으나 비효율적이다.
구버전 옵션 확인 방법
- 인터넷 아카이브를 활용하여 확인하는 방법
https://web.archive.org/
위의 링크로 접속시 특정 사이트의 과거 게시물을 확인할 수 있다. 여러 메체의 과거 게시물들을 업로드하여 저장해 놓은 사이트인데, 사이트의 회원이면 모두 업로드 가능한 듯하다. 인터넷, TV 등 휘발성으로 소멸하는 정보를 저장하기 위한 사이트로 원하는 사이트의 url을 입력하여 업로드하는 방식으로 보인다.
https://www.idangero.us/ 또는 https://swiperjs.com/ url을 검색창에 입력하면 타임라인으로 특정 년도와 월을 선택하고, 해당 시기에 배포된 버전의 옵션을 확인할 수 있다. - 구버전의 라이브러리를 다운받아 보는 방법
1번의 방법보다 확실히 번거로운 방법이다. 일단 직접 코드를 열어 확인해야 하므로 수월하지는 않고 앞서 말하였듯이 비효율적이다. 옵션을 확인해야 한다기보다, 특정 버전의 라이브러리를 필요로할 경우 유용하다.
swiper 사이트에서는 지금까지 배포된 버전의 서비스를 제공하지 않지만 다운로드를 받을 수는 있다.
Docs > Getting Started > Installation > Download assets 메뉴로 순차적으로 이동하면 jsdelivr 링크가 하나 보인다. (https://www.jsdelivr.com/package/npm/swiper) 이 곳의 Files 메뉴에서 버전을 선택하여 다운로드가 가능하다.
참조 링크
https://web.archive.org/web/20150722024829/http://www.idangero.us/swiper/api/#.Va8EgezP1qY
https://www.jsdelivr.com/package/npm/swiper?tab=files