스킨 Customize 시작가이드
목차
- 파일위치
- 스킨에 대한 참조 얻기
- 이벤트 콜백함수 사용
- CSS Skinning 참조
파일위치
제공한 소스의 skin폴더의 skin.html 에서 수정합니다.
- html 수정 : skin/skin.html 요소수정및 스크립트 수정
- css수정할 폴더위치 : skin/_inc 하위 폴더 css를 수정합니다.
- 이미지수정 폴더위치 : skin/_images 하위폴더 이미지 수정합니다.
- 수정할 js 파일위치 : skin/mcplayer.js API 사용한 동작스크립트 수정
스킨에 대한 참조 얻기
skin.min.js 가 include 되어있습니다. 위 자바스크립트가 설정되어있다면
MCSkin 이란 인스턴스가 생성되어있습니다.
이 객체를 통해 아래에 있는 Skin API를 사용하여 이벤트발생시, 혹은 클릭시 등의 스크립트 변경을 통해
좀더 동적으로 Skin 을 커스텀 할수 있습니다.
이벤트 콜백함수 사용
skin api에는 전체적으로 parameter 맨 마지막 인수를 callback함수로 받습니다.
api를 사용할때 특정 동작스크립트를 사용하고 싶다면 다음과 같이 사용하면 됩니다.
재생/일시정지 토글예제
$('#버튼').click(function(){
MCSkin.playPause(); //재생/일시정지 기능사용
});
재생/일시정지 토글 콜백함수 사용예제
MCSkin.playPause(function(state){
alert('재생/일시정지토글시 skin 변화 로직 콜백함수입니다.');
//예제 - state 값을 받아서 값에 따라 skin처리
if(state == 'Playing'){
$('#재생버튼').hide();
...
} else if(state == 'Paused'){
$('#일시정지버튼').hide();
...
}
});
CSS Skinning 참조 객체
기능에 따른 html UI의 class명이 존재하고 mc-라는 prefix 규칙을 따르고 있습니다.
좀더 쉽게 사용가능하도록 jquery 변수로 미리 선언되어 있으며
jquery 변수는 $가 변수명앞에 붙는 규칙을 두고 있습니다.
스킨을 커스터마이징할때 미리존재하는 기능변수들을 사용하시면 좀더 쉽게 작업하실수 있습니다.
기능변수를 사용한 상세예제
//플레이 일시정지 토글버튼을 클릭했을때
$mcPlayToggle.click(function(){
//아래와 같이 재생/일시정지 기능과 콜백함수사용
MCSkin.playPause(function(state){
alert('재생/일시정지토글시 skin 변화 로직 콜백함수입니다.');
//예제 - state 값을 받아서 값에 따라 skin처리
if(state == 'Playing'){
$('#재생버튼').hide();
...
} else if(state == 'Paused'){
$('#일시정지버튼').hide();
...
}
});
});
기능에 따른 변수들의 상세표들은 아래와 같습니다.
control
기능변수(jqeury객체) | key | value | attr | 설명(UI) |
---|---|---|---|---|
$mcPlayToggle | playToggle | .mc-play-toggle | play/pause토글기능클래스 | |
$mcPrgrsBg | prgrsBg | .mc-prgrs-bg | 진행바영역 | |
$mcPrgrsBall | prgrsBall | .mc-prgrs-ball | 진행바볼(커서) | |
$mcPrgrsBar | prgrsBar | .mc-prgrs-bar | 진행율바 | |
$mcCurrTime | currTime | .mc-curr-time | 현재시간 | |
$mcTotalTime | totalTime | .mc-total-time | 전체시간 | |
$mcSkipPlay | skipPlay | .mc-skip-play | skip-time,skip-type | 탐색기능클래스(시간과F:ff,R:rew타입지정attr있음) |
$mcSkipView | skipView | .mc-skip-view | 탐색보는UI클래스 | |
$mcSkipFF | skipFF | .mc-skip-play.mc-ff | ff탐색 | |
$mcSkipRew | skipREW | .mc-skip-play.mc-rew | rew탐색 | |
$mcMuteToggle | muteToggle | .mc-mute-toggle | 음소거토글 |
volume
기능변수(jqeury객체) | key | value | attr | 설명(UI) |
---|---|---|---|---|
$mcVolume | volume | .mc-volume | 볼륨전체영역 | |
$mcVolumeBar | volumeBar | .mc-volume-bar | 볼륨바 | |
$mcVolumeBall | volumeBall | .mc-volume-ball | 볼륨볼(커서) | |
$mcVolumeBg | volumeBg | .mc-volume-bg | 볼륨영역 | |
$mcVolumeShowToggle | volumeShowToggle | .mc-volume-show-toggle | 볼륨토글 | |
$mcVolumeShow | volumeShow | .mc-volume-show | 보여줘야할볼륨트랙바 | |
$mcVolumeShows | volumeShows | .mc-volume-show-toggle,mc-volume-show | 볼륨토글과보여줘야할볼륨트랙바 |
preview
기능변수(jqeury객체) | key | value | attr | 설명(UI) |
---|---|---|---|---|
$mcPreviewScreen | previewScreen | .mc-preview-screen | 미리보기스크린 | |
$mcPreviewText | previewText | .mc-preview-text | 미리보기텍스트영역 |
default
기능변수(jqeury객체) | key | value | attr | 설명(UI) |
---|---|---|---|---|
$mcDefaultMenu | defaultMenu | .mc-default | 기본메뉴 | |
$mcSpeedMenus | speedMenus | .mc-popup-speed.mc-menu | 배속팝업메뉴에각메뉴들 | |
$mcSpeedMenu | speedMenu | .mc-popup-speed | 배속메뉴 | |
$mcSpeedViews | speedViews | .mc-speed-view | 배속텍스트보기 | |
$mcSpeedBtns | speedBtns | .mc-speed-btn | 배속버튼 | |
$mcCaptionBtn | captionBtn | .mc-caption-btn | 자막버튼 | |
$mcMenuClass | menuClass | .mc-menu | 메뉴클래스들 | |
$mcMenuText | menuText | .mc-menu-text | 메뉴에텍스트클래스들 | |
$mcSubmenuClass | submenuClass | .mc-sub-menu | 메뉴에서브메뉴클래스들 | |
$mcSelectedClass | selectedClass | .mc-selected | selected클래스 | |
$mcUnderlineClass | underlineClass | .mc-underline | underline클래스 | |
$mcSetting | setting | .mc-setting | 환경설정 | |
$mcSettingBtn | settingBtn | .mc-setting-btn | 환경설정버튼 | |
$mcSettingMenu | settingMenu | .mc-setting-menu | 환경설정의메뉴 | |
$mcSettingSub | settingSub | .mc-setting-sub | 환경설정의서브메뉴 | |
$mcSettingBack | settingBack | .mc-setting-back | 환경설정의뒤로가기 | |
$mcSettingSpeedMenus | settingSpeedMenus | .mc-setting-speed.mc-sub-menu | 환경설정의배속의서브메뉴 | |
$mcSettingSpeedMenu | settingSpeedMenu | .mc-setting-speed | 환경설정의배속 | |
$mcSettingSpeedViews | settingSpeedViews | .mc-speed-view | 배속보기 | |
$mcSettingSkipMenus | settingSkipMenus | .mc-setting-skip.mc-sub-menu | 환경설정의탐색의서브메뉴 | |
$mcSettingSkipMenu | settingSkipMenu | .mc-setting-skip | 환경설정의탐색 | |
$mcSettingSkipViews | settingSkipViews | .mc-skip-view | 탐색보기 | |
$mcSettingRepeatMenus | settingRepeatMenus | .mc-setting-repeat.mc-sub-menu | 환경설정의구간반복의서브메뉴 | |
$mcSettingRepeatMenu | settingRepeatMenu | .mc-setting-repeat | 환경설정의구간반복 | |
$mcSettingRepeatViews | settingRepeatViews | .mc-repeat-view | 구간반복보기 | |
$mcSettingCaptionMenus | settingCaptionMenus | .mc-setting-caption.mc-sub-menu | 환경설정의자막의서브메뉴 | |
$mcSettingCaptionMenu | settingCaptionMenu | .mc-setting-caption | 환경설정의자막 | |
$mcSettingCaptionViews | settingCaptionViews | .mc-caption-view | 자막보기 | |
$mcFullscreen | fullscreen | .mc-fullscreen | 풀스크린 | |
$mcFullscreenToggle | fullscreenToggle | .mc-fullscreen-toggle | 풀스크린토글기능클래스 | |
$mcRepeatBtn | repeatBtn | .mc-repeat-btn | 구간반복버튼 | |
$mcPins | pins | .mc-pin-a,.mc-pin-b | 구간반복마커들 | |
$mcPinA | pinA | .mc-pin-a | 구간반복앞쪽마커 | |
$mcPinB | pinB | .mc-pin-b | 구간반복뒤쪽마커 | |
$mcImgToggle | imgToggle | .mc-img-toggle | 이미지토글클래스 | |
$mcGuideToggle | guideToggle | .mc-guide-toggle | 가이드토글클래스 | |
$mcGuide | guide | .mc-guide | 가이드영역 | |
$mcGuideBox | guideBox | .mc-guide-box | 가이드박스 | |
$mcGuideTxt | guideTxt | .mc-guide-txt | 가이드텍스트 | |
$mcGuideImg | guideImg | .mc-guide-img | 가이드이미지 | |
$mcBmrkBtn | bmrkBtn | .mc-bmrk-btn | 북마크버튼 | |
$mcBmrkPins | bmrkPins | .mc-bmrk-pins | 북마크마커들 | |
$mcBmrkPin | bmrkPin | .mc-bmrk-pin | 북마크마커 | |
$mcBmrkPinRef | bmrkPinRef | #mc-bmrk-pin-ref | 북마크참조마커(반드시id) | |
$mcBmrkPinsPin | bmrkPinsPin | .mc-bmrk-pins.mc-bmrk-pin | 북마크마커들의각마커 | |
$mcAlert | alert | .mc-alert | 얼럿 | |
$mcAlertText | alertText | .mc-alert-text | 얼럿텍스트 | |
$mcSettingLanguageMenus | settingLanguageMenus | .mc-setting-language.mc-sub-menu | 환경설정의언어의서브메뉴 | |
$mcSettingLanguageMenu | settingLanguageMenu | .mc-setting-language | 환경설정의언어 | |
$mcSettingLanguageViews | settingLanguageViews | .mc-language-view | 언어보 |