插件架構設計
;(function($) {
// 1. 默認配置
const DEFAULTS = {
width: 500,
height: 300,
showTitle: true,
interval: 3000,
animation: 'fade', // fade | slide | none
autoPlay: true,
pauseOnHover: true,
navigation: true, // 分頁器
arrows: true, // 上下箭頭
cssLink: '' // 外部樣式
};
// 2. 構造函數
class Slider {
constructor(element, options) {
this.$el = $(element);
this.opts = $.extend({}, DEFAULTS, options);
this.current = 0;
this.timer = null;
this.$slides = this.$el.find('.slider-list li');
this.count = this.$slides.length;
this.init();
}
init() {
this.setupDOM();
this.bindEvents();
this.loadCSS();
if (this.opts.autoPlay) this.startAutoPlay();
}
setupDOM() {
// 容器樣式
this.$el.css({width: this.opts.width, height: this.opts.height, position: 'relative', overflow: 'hidden'});
this.$slides.css({position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', display: 'none'})
.eq(0).show();
// 生成導航
if (this.opts.navigation) this.createNavigation();
if (this.opts.arrows) this.createArrows();
if (this.opts.showTitle) this.createTitle();
}
createNavigation() {
this.$nav = $('').appendTo(this.$el);
this.$slides.each((i, slide) => {
const title = $(slide).find('img').attr('alt') || i + 1;
$('').text(title).appendTo(this.$nav);
});
this.$navItems = this.$nav.find('li').eq(0).addClass('active').end();
}
// ... 省略 createArrows, createTitle, bindEvents, loadCSS 等方法
goTo(index) {
if (index < 0) index = this.count - 1;
if (index >= this.count) index = 0;
if (index === this.current) return;
this.$slides.eq(this.current).fadeOut(300);
this.$slides.eq(index).fadeIn(300);
this.updateNav(index);
this.current = index;
}
next() { this.goTo(this.current + 1); }
prev() { this.goTo(this.current - 1); }
startAutoPlay() {
this.timer = setInterval(() => this.next(), this.opts.interval);
}
stopAutoPlay() {
clearInterval(this.timer);
this.timer = null;
}
destroy() {
this.stopAutoPlay();
this.$el.off('.slider');
this.$nav?.remove();
this.$arrows?.remove();
this.$title?.remove();
this.$el.removeData('slider');
}
}
// 3. jQuery 插件橋接
$.fn.imgSlider = function(options) {
return this.each(function() {
if (!$.data(this, 'slider')) {
$.data(this, 'slider', new Slider(this, options));
}
});
};
// 4. 公開 API 訪問
$.fn.imgSlider.getInstance = function(el) {
return $(el).data('slider');
};
})(jQuery);
HTML 結構規範
<div id="banner" class="slider">
<ul class="slider-list">
<li><img src="1.jpg" alt="標題一"></li>
<li><img src="2.jpg" alt="標題二"></li>
<li><img src="3.jpg" alt="標題三"></li>
</ul>
</div>
<script>
$('#banner').imgSlider({
width: 800,
height: 400,
interval: 5000,
animation: 'slide'
});
// 外部控制
const slider = $('#banner').imgSlider.getInstance('#banner');
slider.goTo(2);
slider.stopAutoPlay();
</script>
進階功能擴展
- 觸摸滑動:集成 Hammer.js 或原生 touch 事件,支持手機滑動切換
- 懶加載:
data-src 屬性,可視區域加載
- 動畫類型:CSS Transition/Animation 替代 jQuery animate,啟用 GPU 加速
- 無障礙:ARIA roles、鍵盤導航、螢幕閱讀器支持
- 響應式:
window.resize 重新計算尺寸,圖片 srcset 適配
現代化重寫方向
// ES Module + Web Component 版本
class ImgSlider extends HTMLElement {
static get observedAttributes() { return ['width', 'height', 'interval']; }
constructor() { super(); this.attachShadow({mode: 'open'}); }
connectedCallback() { this.render(); this.init(); }
// ...
}
customElements.define('img-slider', ImgSlider);