照片輪播使用指南
照片輪播使用指南
📁 資料夾結構
assets/
└── images/
└── carousel/ # 輪播照片專用資料夾
├── README.md # 使用說明
├── placeholder.txt # 佔位檔案
└── [您的照片檔案]
📸 如何添加輪播照片
1. 準備照片
- 格式:JPG 或 PNG
- 尺寸:建議 1200x500 像素以上
- 比例:橫向照片(寬度大於高度)
- 檔案大小:不超過 2MB
2. 上傳照片
將您的照片檔案放入 assets/images/carousel/ 資料夾中
3. 更新輪播內容
編輯 photos.html 檔案,在輪播區域添加新的照片:
<div class="photo-carousel-slide">
<img src="/assets/images/carousel/%E6%82%A8%E7%9A%84%E7%85%A7%E7%89%87%E6%AA%94%E6%A1%88.jpg" alt="照片描述">
<div class="photo-carousel-caption">
<h3>照片標題</h3>
<p>照片描述</p>
</div>
</div>
4. 更新指示器
在 photos.html 中找到輪播指示器區域,添加對應的指示器:
<div class="photo-carousel-indicators">
<span class="photo-carousel-dot active" onclick="currentPhotoSlide(1)"></span>
<span class="photo-carousel-dot" onclick="currentPhotoSlide(2)"></span>
<!-- 為每張照片添加一個指示器 -->
</div>
🎯 建議的照片內容
- 雙語教學活動
- 國際交流活動
- 教師研習活動
- 學生成果展示
- 學校特色活動
- 外師教學場景
📝 檔案命名建議
使用描述性的檔案名稱:
carousel-01-雙語體育課程.jpgcarousel-02-國際志工活動.jpgcarousel-03-外師教學.jpgcarousel-04-教師研習.jpg
⚙️ 輪播設定
自動輪播
- 每 4 秒自動切換到下一張照片
- 可在
assets/js/photo-carousel.js中調整時間間隔
手動控制
- 左右箭頭按鈕可手動切換
- 底部指示器可直接點擊切換
響應式設計
- 桌面版:500px 高度
- 手機版:300px 高度
- 自動適應不同螢幕尺寸
🔧 技術細節
CSS 類別
.photo-carousel-container:輪播容器.photo-carousel-slide:單張照片.photo-carousel-caption:照片標題區域.photo-carousel-dot:指示器
JavaScript 函數
showPhotoSlide(n):顯示指定照片movePhotoCarousel(direction):移動輪播currentPhotoSlide(n):點擊指示器切換
📱 手機版優化
輪播在手機上會自動調整:
- 照片高度縮小到 300px
- 控制按鈕變小
- 標題字體縮小
- 保持觸控友好的操作體驗
🎨 自訂樣式
如需調整輪播外觀,可編輯 assets/css/style.css 中的相關樣式:
.photo-carousel-container {
/* 調整容器樣式 */
}
.photo-carousel-slide {
/* 調整照片樣式 */
}
.photo-carousel-caption {
/* 調整標題樣式 */
}
📞 需要協助?
如果您在添加照片或調整輪播時遇到問題,請參考:
assets/images/carousel/README.md- 詳細使用說明photos.html- 現有的輪播範例assets/js/photo-carousel.js- JavaScript 功能說明