官網:GitHub
<script src="jquery.min.js"></script>
<script src="jquery.backstretch.min.js"></script>
$(function() {
// 單張
$.backstretch("bg.jpg");
// 多張輪播 (4秒切換,0.5秒淡入淡出)
$.backstretch([
"bg1.jpg",
"bg2.jpg",
"bg3.jpg"
], { duration: 4000, fade: 500 });
// 指定容器背景 (非 body)
$(".hero").backstretch("hero-bg.jpg");
$(".sidebar").backstretch(["side1.jpg", "side2.jpg"], { duration: 6000, fade: 800 });
});
| 選項 | 類型 | 預設 | 說明 |
|---|---|---|---|
| duration | Number | 5000 | 輪播間隔 (毫秒) |
| fade | Number | 0 | 淡入淡出過渡時間 (毫秒),0=無動畫硬切 |
| alignX | Number | 0.5 | 水平對齊:0=左, 0.5=中, 1=右 |
| alignY | Number | 0.5 | 垂直對齊:0=頂, 0.5=中, 1=底 |
| centeredX/Y | Boolean | true | 是否居中 (覆蓋 alignX/Y) |
| paused | Boolean | false | true=暫停輪播 |
| start | Number | 0 | 起始圖片索引 |
| preload | Boolean | true | 預載入下一張 |
| preloadSize | Number | 1 | 預載張數 |
| resolutionRefreshRate | Number | 2500 | 響應式重算間隔 (ms) |
var bg = $.backstretch(["a.jpg", "b.jpg"], {duration: 3000});
// 暫停/繼續
bg.pause(); bg.resume();
// 跳轉指定圖
bg.show(1); // 索引 1 (b.jpg)
bg.next(); // 下一張
bg.prev(); // 上一張
// 動態新增/移除
bg.add("c.jpg");
bg.remove(0); // 移除索引 0
// 銷毀
bg.destroy(); // 移除背景、事件、定時器
/* 容器透明度讓背景透出 */
.container { background: rgba(255,255,255,0.85); position: relative; z-index: 1; }
/* 修正 body 邊距導致白邊 */
body { margin: 0; }
/* 載入中佔位 */
.backstretch img { opacity: 0; transition: opacity 0.5s; }
.backstretch img.loaded { opacity: 1; } /* 插件自動添加 .loaded 類 */
.fullscreen-bg {
position: fixed; top: 0; left: 0; width: 100%; height: 100%; z-index: -1;
background: url('bg1.jpg') center/cover no-repeat;
animation: bgFade 20s infinite;
}
@keyframes bgFade {
0%, 20% { background-image: url('bg1.jpg'); }
33%, 53% { background-image: url('bg2.jpg'); }
66%, 86% { background-image: url('bg3.jpg'); }
}
/* 注意:CSS 背景圖切換無淡入淡出過渡 (background-image 不可 transition) */
/* 需淡入淡出疊多層絕對定位圖片 + opacity 動畫 */
現代專案:簡單全屏背景用 CSS;需 JS 控制、輪播淡變、元素級背景 → Backstretch;React/Vue 專用組件 (如 `react-backstretch`)。