맨위로가기
 

SBUx

닫기

Carousel

이미지와 태그를 슬라이드 형태로 사용하는 carousel 컴포넌트 입니다.

기본 사항

사항 설명 비고
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 사항

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