Swiper

가이드 모음

기본 가이드

  • 설계 단계의 특별한 UX 요청이나 개발 환경에 따른 제약으로 개발 요청 사항이 없다면 테스트 완료된 코드를 복사 붙여 넣기를 기본으로 합니다.

자주 쓰이는 옵션

  • data-desktop-only="true": PC에서 swiper, MO에서 해제
  • data-mobile-only="true": MO에서 swiper, PC에서 해제
  • slidesPerView: 한 슬라이드에 보여줄 갯수 (default: 1)
  • spaceBetween: 슬라이드 사이 여백 (default: 0)
  • loop: 슬라이드 반복 여부 (default: false)

Swiper Navigation

data-props-navigation="true"를 설정하면, 별도의 추가 마크업 없이 자동으로 .swiper-controls 내부에 네비게이션 요소가 생성됩니다.
또한, 원하는 경우 data-props-navigation-class를 통해 커스텀 클래스를 지정하여 스타일을 적용할 수 있습니다.
  • 구성 요소
    • 컴포넌트 클래스: component-swiper
    • 컨트롤 클래스: swiper-controls, swiper-navigation
표제목 : 제목1, 제목2, 제목3, 제목4
Name Description Type Default
pagination
슬라이드 갯수 표시 버튼 생성 여부
boolean
false
slideChange
슬라이드 변경후 콜백
function
null
paginationType
슬라이드 갯수 표시 디자인 타입
string
bullets
breakpoint
반응형 요서 업데이트 { “사이즈” : 옵션 오브젝트 재 설정 }
object
null
navigation
이전, 다음 버튼 생성 여부
boolean
false
initialSlide
초기 slide의 위치
number
0
slidesPerView
슬라이드 보여질 갯수
number
1
speed
slide 전환될 때의 시간
number
1000
nested
스와이퍼 안에 스와이퍼일때 자식 스와이퍼에 적용
boolean
false
spaceBetween
슬라이드 사이 간격
number
0

Swiper Pagination

data-props-pagination="true"를 설정하면, 별도의 추가 마크업 없이 자동으로 .swiper-controls 내부에 페이지네이션 요소가 생성됩니다.
원하는 경우 data-props-pagination-class를 통해 커스텀 클래스를 지정하여 스타일을 적용할 수 있습니다.
  • 구성 요소
    • 컴포넌트 클래스: component-swiper
    • 컨트롤 클래스: swiper-controls, swiper-pagination

Swiper Breakpoints

  • 구성 요소
    • 컴포넌트 클래스: component-swiper