사항 | 설명 | 비고 | |
---|---|---|---|
HTML 태그 형태 | <sbux-carousel></sbux-carousel> |
||
필수 속성 | id, name, uitype | 고정형 | |
변동형 | jsondata-ref | ||
* 2.6.962 버전이후 변경사항 : - id 속성 미사용시 name 값으로 자동 매핑 - uitype 속성 미사용시 SBUxDefault.js 에 설정된 값으로 자동 매핑 |
|||
uitype 속성 값 | tag, image | ||
자식 Dom 구조 | 고정형 | <content-item> |
슬라이드 item 을 구성하는 구조 |
변동형 | JSON Data 사용 |
가변적인 데이터시 사용 |
예시) HTML 형태의 개발 - 고정형 |
---|
<!-- 이미지를 사용하는 형태 --> <sbux-carousel id="idxCarousel1" name="carouselNm1" uitype="image" circulation="true" auto-stream="stream" auto-stream-interval="1000" is-indicartor="true"> <content-item image-src="./1.jpg" selected></content-item> <content-item image-src="./2.jpg"></content-item> <content-item image-src="./3.jpg"></content-item> <content-item image-src="./4.jpg"></content-item> </sbux-carousel> <!-- 일반 또는 SBUx Tag 를 사용하는 형태 --> <sbux-carousel id="idxCarousel3" name="carouselNm3" uitype="tag"> <content-item> <sbux-input id="input1" name="input1" uitype="text"></sbux-input> <sbux-input id="input2" name="input2" uitype="password"></sbux-input> <sbux-datepicker id="picker1" name="picker1" uitype="date" mode="inline"> </sbux-datepicker> </content-item> <content-item> <sbux-datepicker id="picker2" name="picker2" uitype="date" mode="popup"> </sbux-datepicker> <sbux-textarea id="textarea" name="textarea" uitype="normal"></sbux-textarea> <sbux-listbox id="idxListbox_single" name="listbox_single" uitype="single"> <option-item text="1"></option-item> <option-item text="2"></option-item> <option-item text="3"></option-item> </sbux-listbox> <sbux-select id="select1" name="select1" uitype="single"> <option-item text="1" value="1">1</option-item> <option-item text="2" value="2">2</option-item> <option-item text="3" value="3">3</option-item> </sbux-select> </content-item> <content-item> <sbux-tabs id="idxTab_norm" name="tab_norm" uitype="normal" title-target-id-array = "SBUx_JS^SBUx_IDE^SBGrid2_5" title-text-array = "SBUx Tab^SBUx IDE Tab^SBGrid Tab"></sbux-tabs> </content-item> </sbux-carousel> |
예시) HTML 형태의 개발 - 변동형 |
---|
<script> var carouselJosnData=[ {src:'./1.jpg', order:'1', selected:'selected'}, {src:'./2.jpg', order:'2', link:'www.naver.com'}, {src:'./3.jpg', order:'3'}, {src:'./4.jpg', order:'4'} ]; </script> <sbux-carousel id="idxCarousel2" name="carouselNm2" uitype="image" jsondata-ref="carouselJosnData" jsondata-order="order" jsondata-link="link" jsondata-src="src" slide-effect="fade"> </sbux-carouel> |
예시) jQuery Plugin 형태의 개발 |
---|
<div id="sbArea"></div> <script> var carouselJsonData=[ {imagesrc:'./../img/image1.jpg'}, {imagesrc:'./../img/image2.jpg'}, {imagesrc:'./../img/image3.jpg'} ]; $(document).ready(function(){ $('#sbArea').sbCarousel({ name : 'sbScriptNm', uitype : 'image', jsondataRef : 'carouselJsonData' }); }); </script> |
속성명 | 설명 / 유형(t:tag, i:image) | 비고 | |
---|---|---|---|
content-id-array | <sbux-carouel>내에 <content-item>이 없는 형태로 내/외부에 존재하는 content 를 호출할때 content 를 값싸는 div 의 id를 '^' 구분자로 나열 |
t | (사용자 지정) |
circulation | 슬라이드가 연속적으로 순환 | t | i | (true | false) |
is-controller | 이전,다음 슬라이드로 이동할 수 있는 버튼 보이기 | t | i | (true | false) |
is-indicartor | 원하는 슬라이드로 바로 이동 할 수 있는 버튼 보이기 | t | i | (true | false) |
auto-stream | 슬라이드가 일정 시간마다 자동으로 다음으로 이동 | t | i | (none | stream | reverse) |
auto-stream-interval | 슬라이드가 이동하는데 지연되는 시간 | t | i | (600 | 사용자 지정) |
mouse-wheel-move | 마우스 휠로 슬라이드 이동 사용 여부 | t | i | (false | true) |
pause | auto-stream 중인 슬라이드 일시정지 이벤트 | t | i | (none | click | hover) |
is-pause-button | puase="click" 속성 사용시 상단에
pause 상태인지 아닌지 확인 가능한 버튼 보이기 |
t | i | (false | true) |
slide-effect | 슬라이드 화면 전환 시 효과 | t | i | (none | hslide | vslide | fade) |
not-found-text | 슬라이드 item 이 없을때 표시하는 문구 | t | i | (사용자 지정) |
is-controlbox | controller 와 indicator 를 carousel 외부의 별도 box 로 이동 |
t | i | (true | false) |
controlbox-direction | controlbox 위치 지정 | t | i | (bottom) |
is-unfolded | 이전 이미지와 다음 이미지를 한 번에 확인 할 수 있도록 UI 형태를 변경할 지 설정하는 속성입니다. | i | (false | true) |
use-blur-to-unfolded-images | unfolded image들에 대한 blur 효과를 적용할 지 설정하는 속성입니다. | i | (false | true) |
unfolded-prev-style | 이전 이미지의 스타일을 설정하는 속성입니다. is-unfolded가 true일 때 동작합니다. |
i | unfolded-prev-style="position: absolute; width: 50%; height: 80%;" |
unfolded-next-style | 다음 이미지의 스타일을 설정하는 속성입니다. is-unfolded가 true일 때 동작합니다. |
i | unfolded-prev-style="position: absolute; width: 50%; height: 80%;" |
lazyloading | 초기 로딩시 select된 슬라이드의 tag만 생성,
슬라이드 이동에 따라 tag를 동적으로 생성하는 속성 |
t | (false | true) |
callback-before-change | 슬라이드가 이동되기 전에 callback
함수를 호출하여 슬라이드 변경을 제어하는 속성 |
t | i | (return false 인경우 슬라이드 이동 중단) |
callback-after-change | 슬라이드가 이동된 후에 callback
함수를 호출하여 슬라이드 변경됨을 알리는 속성 |
t | i | |
onclick | 클릭시 이벤트 | t | i | |
ondblclick | 더블 클릭시 이벤트 | t | i |
하위구조 태그명 | 속성명 | 설명 | 비고 |
---|---|---|---|
<content-item> | 각 노드의 item 을 구성하는 구조 | ||
image-src | uitype='image' 시 image 를 호출하는 주소 | ||
order | 항목의 순서를 지정하는 속성 | ||
selected | 초기 로딩시 선택 속성 | ||
link | 클릭시 이동하는 주소 | ||
target | 설정된 link가 열리는 방식 |
속성명 | 설명 / 유형(t:tag, i:image) | 비고 | |
---|---|---|---|
circulation | 슬라이드가 연속적으로 순환 | i | (true | false) |
is-controller | 이전,다음 슬라이드로 이동할 수 있는 버튼 보이기 | i | (true | false) |
is-indicartor | 원하는 슬라이드로 바로 이동 할 수 있는 버튼 보이기 | i | (true | false) |
auto-stream | 슬라이드가 일정 시간마다 자동으로 다음으로 이동 | i | (none | stream | reverse) |
auto-stream-interval | 슬라이드가 이동하는데 지연되는 시간 | i | (600 | 사용자 지정) |
mouse-wheel-move | 마우스 휠로 슬라이드 이동 사용 여부 | i | (false | true) |
pause | auto-stream 중인 슬라이드 일시정지 이벤트 | i | (none | click | hover) |
is-pause-button | puase="click" 속성 사용시 상단에
pause 상태인지 아닌지 확인 가능한 버튼 보이기 |
i | (false | true) |
slide-effect | 슬라이드 화면 전환 시 효과 | i | (none | hslide | vslide | fade) |
not-found-text | 슬라이드 item 이 없을때 표시하는 문구 | i | (사용자 지정) |
is-controlbox | controller 와 indicator 를 carousel 외부의 별도 box 로 이동 |
i | (true | false) |
controlbox-direction | controlbox 위치 지정 | i | (bottom) |
jsondata-ref | json data 참조 변수명 예시) json data 구조 var jsondata = [{ imagesrc:'./../A011.jpg', order: 1, link:'./A011.html',selected:'selected'}] |
i | (사용자지정) |
jsondata-image-src | json data 내 image 경로 참조 키명 | i | (imagesrc | 사용자지정) |
jsondata-image-alt | json data 내 image alt 참조 키명 | i | (imagealt | 사용자지정) |
jsondata-image-title | json data 내 image title 참조 키명 | i | (imagetitle | 사용자지정) |
jsondata-link | json data 내 link 참조 키명 | i | (link | 사용자지정) |
jsondata-order | json data 내 order 참조 키명 | i | (ordedr | 사용자지정) |
callback-before-change | 슬라이드가 이동되기 전에 callback
함수를 호출하여 슬라이드 변경을 제어하는 속성 |
i | (return false 인경우 슬라이드 이동 중단) |
callback-after-change | 슬라이드가 이동된 후에 callback
함수를 호출하여 슬라이드 변경됨을 알리는 속성 |
i | |
onclick | 클릭시 이벤트 | i | |
ondblclick | 더블 클릭시 이벤트 | i |
API 명 | 설명 / 유형(t:tag, i:image) | Parameters | |
---|---|---|---|
SBUxMethod.setCarouselSlide | 설정된 슬라이드번호로 이동 | t | i | ('모델명',슬라이드 번호) |
SBUxMethod.getCarouselSlide | 현재 슬라이드 번호 반환 | t | i | ('모델명') |
SBUxMethod.addCarouselSlide | 현재 슬라이드 번호 반환 | t | i | tag type
: ('모델명', '추가할 태그', 추가할 위치) image type : ('모델명', {options}, 추가할 위치) {options} : {imagesrc : '이미지 url', link : '선택시 이동 url'} |
SBUxMethod.removeCarouselSlide | 삭제할 슬라이드 번호 | t | i | ('모델명',슬라이드 번호) |
SBUxMethod.getCarouselCount | 총 슬라이드 개수를 반환 | t | i | ('모델명') |
SBUxMethod.refresh | 재호출 | t | i | |
SBUxMethod.hide | 감추기 | t | i | |
SBUxMethod.show | 보이기 | t | i |