1.0.1 • Published 7 years ago
swipebase v1.0.1
SwipeBase
##Introduce 모바일 사이트에서 많이 사용되어지는 플리킹 플러그인입니다. jQuery plugin을 지원하며 슬라이더의 무한 루프와 페이징 기능등이 있습니다.
##How to Use ####html 아래와 같이 감싸는 태그와 리스트 태그, 그리고 리스트의 아이템 태그로 작성합니다.
<div class="listWrap">
<ul class="list">
<li><div style="background: red;">0</div></li>
<li><div style="background: brown;">1</div></li>
<li><div style="background: orange;">2</div></li>
</ul>
</div>
####css 아래와 같이 길이와 높이값을 반드시 기입해야 합니다.
.listWrap {
width: 100%;
height: 100px;
}
.list li {
width: 100%;
height: 100px;
}
####javascript jquery 플러그인을 작성할 경우 아래와 같이 작성합니다.
$( '.listWrap' ).swipeBase();
javascript으로 작성할 경우 아래와 같이 작성합니다.
new SwipeBase({
wrap: document.querySelectorAll( '.listWrap' )[ 0 ],
list: document.querySelectorAll( '.listWrap li' ),
});
##method
###jquery method
- swipeBase2start: 슬라이더쇼 시작
- swipeBase2stop: 슬라이더쇼 정지
- swipeBase2refresh: 가로 크기 재반영
- swipeBase2setHeight: 높이 재반영
- swipeBase2prev: 이전 슬라이더 이동
- swipeBase2next: 다음 슬라이더 이동
- swipeBase2slide: {index} 현재 슬라이더 인덱스
- swipeBase2destory: 제거
- swipeBase2touchEnable: 터치 잠금 해제
- swipeBase2touchDisable: 터치 잠금
###javascript method
- startSlideShow: 슬라이더쇼 시작
- stopSlideShow: 슬라이더쇼 정지
- refreshSize: 가로 크기 재반영
- setHeight: 높이값 설정
- getIdx: 현재 슬라이더 인덱스
- toNext: 다음 슬라이더 이동
- toPrev: 이전 슬라이더 이동
- toSlide: {index} 지정된 슬라이더 이동
- destory: 제거
- touchEnable: {Boolean} 터치 잠금 해제
- touchDisable: {Boolean or String} 터치 잠금, 'next', 'right'의 경우는 오른쪽 터치만 잠금, 'prev', 'left'의 경우는 왼쪽 터치만 잠금, 기본은 양쪽 모두 잠금.
##option
####jquery option
- $wrap: {jQuery Selector} (default: $( this ).find( 'ul' )) 리스트 감쌈
- $list: {jQuery Selector} (default: $( this ).find( 'ul li' )) 리스트
- $pages: {jQuery Selector} (default: null) 슬라이드 이동 버튼
- $toStart: {jQuery Selector} (default: null) 슬라이드쇼 시작 버튼
- $toStop: {jQuery Selector} (default: null) 슬라이드쇼 멈춤 버튼
- $toPrev: {jQuery Selector} (default: null) 이전 이동 버튼
- $toNext: {jQuery Selector} (default: null) 다음 이동 버튼
####javascript option
- wrap: required {elements} (default: null) 리스트 감쌈
- list: required {elements} (default: null) 리스트
- pages: {elements} (default: null) 슬라이드 이동 버튼
- toStart: {elements} (default: null) 슬라이드쇼 시작 버튼
- toStop: {elements} (default: null) 슬라이드쇼 멈춤 버튼
- toPrev: {elements} (default: null) 이전 이동 버튼
- toNext: {elements} (default: null) 다음 이동 버튼
####common option
- startIdx: {Integer} (default: 0) 시작 리스트
- startEvents: {String} (default: 'click') toStart element 이벤트
- stopEvents: {String} (default: 'click') toStop element 이벤트
- moveEvents: {String} (default: 'click') toPrev and toNext element 이벤트
- pageEvents: {String} (default: 'click') pages element 이벤트
- touchMinumRange: {Integer} (default: 10) 사용자 터치시, 슬라이더로 넘어갈 기준값(백분율)
- duration: {Integer} (default: 400) 애니메이션 시간
- sideTouchLock: {Boolean} (default: false) 루프가 아닐때 양쪽 끝의 터치 여부
- loop: {Boolean} (default: true) 루프 여부. false로 설정시 마지막 슬라이드에서 정지
- slideShowTime: {Boolean or Integer} (default: 3000) 슬라이더쇼 시간
- create: {Function} (default: null) 생성시 콜백 함수
- before: {Function} (default: null) 슬라이더 이동 전 콜백 함수
- active: {Function} (default: null) 슬라이더 이동 후 콜백 함수
##Troubleshooting ISSUES.
##History
- 2015-10-07: 소스 정리 및 간격 기능 제거
- 2015-08-27: 오류 수정
- 2015-08-07: - Android 그래픽 카드 오류 수정 - 슬라이드 애니메이션, 터치 이벤트 충돌 수정 - enable/disable 함수 추가 - sideTouchLock 기능 추가
- 2015-06-02: 세로 스크롤 시 오류 수정.
- 2015-06-15: 리스트 항상 가운데 표출(좌우표출).
- 2015-06-21: 아이폰 세로 스크롤 시 버그 대응, 중복 애니메이션 방지.
Copyrights
- license: http://blim.mit-license.org/
- site: http://www.blim.co.kr/
- email: kkh975@naver.com