專案裡需要一個功能完整的輪播元件——可自訂標題樣式、切換動畫、輪播間隔,還要有開始/暫停控制。Orbit 是 GitHub 上的一個開源方案,本文整理它的效果與用法。
先來個基本見面:

覺得切換太慢?調整間隔即可:

加上標題等其他功能:

換成尺寸更大的圖片:

不想要右上角的小圖示也沒問題:

若對滑動效果不滿意,元件另外提供幾種切換方式。淡入淡出:

水平滑動:

以及圖片定位功能:

Orbit 是一款開放在 GitHub 上的輪播元件,需要 jQuery 支援。
先下載原始碼並引入相關檔案:
<link href="~/Content/orbit-master/orbit-1.3.0.css" rel="stylesheet" /> <script src="~/Content/jquery-1.9.1.js"></script> <script src="~/Content/orbit-master/jquery.orbit-1.3.0.js"></script>
HTML 結構如下:
<div class="container"> <div id="featured"> <img src="/Content/image/Logo/1.jpg" data-caption="#htmlCaption1" /> <img src="/Content/image/Logo/2.jpg" data-caption="#htmlCaption2" /> <img src="/Content/image/Logo/3.jpg" data-caption="#htmlCaption3" /> <img src="/Content/image/Logo/4.jpg" data-caption="#htmlCaption4" /> <img src="/Content/image/Logo/5.jpg" data-caption="#htmlCaption5" /> <img src="/Content/image/Logo/6.jpg" data-caption="#htmlCaption6" /> <img src="/Content/image/Logo/7.jpg" data-caption="#htmlCaption7" /> </div> <!-- Captions for Orbit --> <span class="orbit-caption" id="htmlCaption1"><strong>1</strong></span> <span class="orbit-caption" id="htmlCaption2"><strong>2</strong></span> <span class="orbit-caption" id="htmlCaption3"><strong>3</strong></span> <span class="orbit-caption" id="htmlCaption4"><strong>4</strong></span> <span class="orbit-caption" id="htmlCaption5"><strong>5</strong></span> <span class="orbit-caption" id="htmlCaption6"><strong>6</strong></span> <span class="orbit-caption" id="htmlCaption7"><strong>7</strong></span> </div>
這都是固定結構,其中 id="featured" 是初始化時的掛載點。
最後一行 JS 就完成初始化:
<script type="text/javascript">
$(function () { $('#featured').orbit(); });
</script>
如此就能得到上述圖片的效果。
$('#featured').orbit(); 可以傳入參數客製行為。以下整理了幾個常用屬性:
更多屬性可直接翻閱原始碼:

完整寫法示例:
$('#featured').orbit({
//advanceSpeed: 4000, // 圖片切換時間
//timer: false, // 是否啟用開始暫停功能
//animation: 'fade', // 動畫效果
//captions: false, // 是否啟用標題
//captionAnimation: 'slideOpen', // 標題動畫
//directionalNav: false // 是否啟用上一頁、下一頁
});
除了初始化屬性,元件也綁定了一些可觸發的事件:

呼叫方式如下:
// 定位到第四張圖片(索引從 0 開始)
$("#featured").trigger('orbit.goto', 3);
// 停止輪播
$('#featured').trigger('orbit.stop');
// 恢復輪播
$('#featured').trigger('orbit.start');
此外還有 orbit.next 與 orbit.prev,分別代表切換到下一張與上一張,顧名思義不難理解。
Orbit 最後的維護停在 1.3.0,已多年未更新,且依賴 jQuery。新專案若需要輪播,Bootstrap 本身內建的 Carousel 元件、Swiper 或 Embla 都是更合適的選擇,尤其在需要觸控手勢、無障礙標記與響應式行為時。若只是維護既有系統,本文的屬性與事件整理仍有助於快速上手。