Swiper 다양한 옵션

CSS 24.02.07

Swiper 라이브러리는 다양한 옵션을 제공합니다.



slidesPerView

한 번에 표시할 슬라이드 수를 지정합니다. 예를 들어, slidesPerView: 2로 설정하면 2개의 슬라이드가 화면에 표시됩니다.


spaceBetween

슬라이드 간의 간격을 지정합니다. 슬라이드 간의 여백을 설정하려면 이 값을 조정할 수 있습니다.


loop

슬라이드 루프(무한 회전)를 활성화합니다. 첫 번째 슬라이드 다음에 마지막 슬라이드가 나타납니다.


autoplay

자동 재생을 활성화하고 재생 간격을 설정합니다. 예를 들어, autoplay: { delay: 3000 }로 설정하면 3초마다 슬라이드가 자동으로 전환됩니다.


navigation

이전 및 다음 슬라이드로 이동하는 네비게이션 버튼을 사용합니다. navigation: { nextEl: '.swiper-button-next', prevEl: '.swiper-button-prev' }와 같이 설정할 수 있습니다.


pagination

페이지 번호나 기타 표시할 페이지 지시자를 표시합니다. 예를 들어, pagination: { el: '.swiper-pagination' }로 설정할 수 있습니다.


grabCursor

마우스 커서를 슬라이드에 호버할 때 그랩 커서로 변경합니다.


keyboard

키보드 화살표 키로 슬라이드를 제어할 수 있습니다.


breakpoints

미디어 쿼리에 따라 다른 화면 크기에서 다른 Swiper 옵션을 설정할 수 있습니다.


effect

슬라이드 전환 효과를 지정합니다. 예를 들어, effect: 'fade'는 페이드 인/아웃 효과를 사용합니다.


direction

슬라이드 방향을 지정합니다. 'horizontal' 또는 'vertical' 값을 사용하여 슬라이드 방향을 변경할 수 있습니다.


touchRatio

슬라이드를 드래그할 때의 감도를 조절합니다.


mousewheel

마우스 휠을 사용하여 슬라이드를 이동할 수 있습니다.


centeredSlides

화면 가운데에 슬라이드를 중앙 정렬합니다.


watchOverflow

슬라이드가 화면을 넘어가는 경우에 대한 처리 방법을 설정합니다.


autoplay

자동 재생과 관련된 설정을 구성할 수 있습니다. 예를 들어, autoplay: { delay: 3000, disableOnInteraction: false }로 설정하면 상호 작용 후에도 자동 재생이 유지됩니다.


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
document.addEventListener('DOMContentLoaded', function () {
    var mySwiper = new Swiper('.swiper-container', {
        slidesPerView: 2// 한 번에 표시할 슬라이드 수
        spaceBetween: 20// 슬라이드 간의 간격
        loop: true// 슬라이드 루프(무한 회전) 활성화
        navigation: {
            nextEl: '.swiper-button-next'// 다음 슬라이드로 이동하는 버튼
            prevEl: '.swiper-button-prev' // 이전 슬라이드로 이동하는 버튼
        },
        pagination: {
            el: '.swiper-pagination'// 페이지 표시기
            clickable: true // 페이지 번호 클릭 가능하게 설정
        },
        autoplay: {
            delay: 3000// 3초마다 자동 재생
            disableOnInteraction: false // 사용자 상호 작용 후에도 자동 재생 유지
        },
        effect: 'fade'// 페이드 인/아웃 효과
        direction: 'horizontal'// 슬라이드 방향 (수평)
        touchRatio: 1// 슬라이드 드래그 감도
        mousewheel: true// 마우스 휠로 슬라이드 이동 가능
        centeredSlides: true// 슬라이드 중앙 정렬
        watchOverflow: true // 슬라이드가 화면을 넘어갈 때의 처리 설정
    });
});
cs



이 외에도 Swiper에는 다양한 옵션과 콜백 함수가 있으며, 이러한 옵션을 조합하여 원하는 슬라이드 디자인 및 동작을 구현할 수 있습니다.



예제

See the Pen swiper option by designkits (@designkits) on CodePen.

목록으로
© 디자인키트