---
title: "Astro 實作教學：打造高效滾動進度條的完整範例"
description: "在現代網頁開發中，滾動進度條已成為提升用戶體驗的重要元素，它能直觀地向訪客展示頁面閱讀進度。本文將深入探討如何利用 Astro 框架創建一個高效、輕量級的滾動進度條，並分析其背後的技術原理與優勢。Astro 作為一個專注於性能的現代前端框架，為此類功能實現提供了優秀的開發體驗與執行效率。"
slug: "astro-dynamic-scroll-progress-bar"
date: 2025-04-10T00:00:00.000Z
url: https://calpa.me/blog/astro-dynamic-scroll-progress-bar/
---

## Astro 框架簡介

Astro 是一個新興的現代前端框架，專為創建高性能的靜態 HTML 網站而設計。它主要針對內容豐富的網站，如部落格、文檔站點甚至簡單的企業數字名片等。Astro 的核心理念是「服務器優先」，盡可能在服務器端渲染組件，最大限度減少客戶端的負擔，從而提供卓越的性能體驗。

Astro 框架的三大核心優勢是：
- **速度**：Astro 構建的網站比其他框架替代方案更快
- **彈性**：提供結合純 HTML 與其他 JavaScript 框架（如 React 或 Vue）的自由
- **全能性**：提供創建網站所需的所有工具

隨著近期更新，Astro 已經不再僅限於靜態網站，它引入了動態渲染功能，正逐步縮小與其他框架的差距。

## 滾動進度條的實現原理

在 Astro 中實現滾動進度條相對簡單，我們將通過 HTML、CSS（使用 Tailwind）和 JavaScript 的結合來完成這一功能。下面是具體的實現代碼和解析：

### HTML 結構

```html
<div class="h-4 w-0 bg-blue-500 fixed top-10 left-0" id="progress-bar" transition:persist=""></div>
```

這段代碼定義了進度條的基本 HTML 結構。讓我們來分析各個屬性：

- `h-4`：設置進度條高度為 4 單位（根據 Tailwind 的尺寸系統）
- `w-0`：初始寬度為 0，表示剛開始時沒有進度
- `bg-blue-500`：設置藍色背景
- `fixed top-10 left-0`：固定定位在頁面頂部（距頂部 10 單位）
- `id="progress-bar"`：用於 JavaScript 選取元素
- `transition:persist=""`：這是 Astro 特有的屬性，確保在頁面過渡時保持進度條的狀態

### JavaScript 功能實現

```javascript
/**
 * Updates the progress bar width based on the current scroll position.
 * @function
 * @listens scroll
 */
function updateProgressBar() {
  const progressBar = document.getElementById("progress-bar");
  if (!progressBar) return;
  // 計算頁面滾動百分比
  const scrollPercentage =
    (window.scrollY /
      (document.documentElement.scrollHeight - window.innerHeight)) *
    100;
  progressBar.style.width = `${scrollPercentage}%`;
}

/**
 * Initializes the progress bar functionality.
 * @function
 * @listens astro:page-load
 */
document.addEventListener(
  "astro:page-load",
  () => {
    document.addEventListener("scroll", updateProgressBar);
  },
  { once: true }
);
```

JavaScript 部分包含兩個關鍵元素：

1. **updateProgressBar 函數**：
   - 獲取進度條元素
   - 計算滾動百分比（當前滾動位置 / 最大可滾動距離）
   - 將進度條寬度設置為對應的百分比值

2. **事件監聽**：
   - 監聽 `astro:page-load` 事件，這是 Astro 框架特有的事件，在頁面加載完成時觸發
   - 在頁面加載後，添加滾動事件監聽器，調用 `updateProgressBar` 函數
   - `{ once: true }` 確保事件監聽器只添加一次，避免重複綁定

## 代碼解析與優化

### 滾動百分比計算

```javascript
// 計算頁面滾動百分比
const scrollPercentage =
  (window.scrollY /
    (document.documentElement.scrollHeight - window.innerHeight)) *
  100;
```

這行代碼計算當前的滾動進度百分比：
- `window.scrollY`：當前頁面滾動的垂直位置
- `document.documentElement.scrollHeight`：整個文檔的高度
- `window.innerHeight`：瀏覽器視窗的高度
- `document.documentElement.scrollHeight - window.innerHeight`：最大可滾動距離
- 最後乘以 100 轉換為百分比

### Astro 特有特性的應用

1. **transition:persist 屬性**：
   
   Astro 的 `transition:persist` 屬性確保元素在頁面導航過程中保持其狀態。這對於進度條特別有用，因為它可以在用戶瀏覽不同頁面時保持連續性，提供更順暢的體驗。

2. **astro:page-load 事件**：
   
   Astro 提供了特定的生命週期事件，如 `astro:page-load`，它在頁面內容完全加載後觸發。這比普通的 `DOMContentLoaded` 更可靠，特別是在使用 Astro 的頁面過渡功能時。

## 進度條的樣式定制

Astro 提供了多種方式來自定義進度條的外觀。我們在上面的例子中使用了 Tailwind CSS，但你還可以：

1. **使用不同的顏色**：
   Astro 支持多種顏色選項，可以將 `bg-blue-500` 改為其他顏色類，如 `bg-green-500` 或 `bg-red-500`。

2. **添加過渡效果**：
   可以添加 Tailwind 的 `transition-all` 和 `duration-300` 類來平滑進度條的變化。

3. **使用漸變背景**：
   如果希望有更豐富的視覺效果，可以使用漸變背景，比如 `bg-gradient-to-r from-blue-500 to-purple-500`。

4. **添加標籤**：
   可以在進度條內或外顯示進度百分比，增強用戶體驗。

## 使用 Astro 實現進度條的優勢

![glenn-carstens-peters-npxXWgQ33ZQ-unsplash.avif](https://assets.calpa.me/glenn-carstens-peters-npxXWgQ33ZQ-unsplash.avif)

### 1. 優異的性能

Astro 採用靜態網站生成方式，這意味著它會生成靜態的 HTML 頁面，提供極快的頁面加載速度。在進度條實現上，這種性能優勢表現為極低的初始加載時間和流暢的滾動體驗。

### 2. Islands 架構的優勢

Astro 的 Islands 架構允許開發者在靜態頁面中插入動態組件，這正是我們進度條的實現方式。這種架構最小化了頁面加載時間，同時簡化了代碼複雜度，無需管理大量的 hooks、selectors 或 observables。

### 3. 框架靈活性

Astro 支持多種框架組件，包括 React、Vue 等。這意味著你可以根據需要使用這些框架的組件來擴展進度條功能，而無需引入整個框架庫，確保更快的加載時間。

### 4. 無需客戶端渲染

與需要大量 JavaScript 的框架不同，Astro 專注於服務器端渲染，最小化客戶端 JavaScript。對於進度條這種簡單的 UI 元素，這意味著更快的響應時間和更低的資源消耗。

### 5. 簡化的開發體驗

Astro 提供了直觀的 API 和清晰的文檔，使得實現進度條等功能變得簡單。開發者可以專注於功能邏輯，而不是框架複雜性。

## 進階應用與擴展

### 1. 自定義進度條行為

你可以擴展基本功能，例如：
- 添加平滑動畫
- 在特定閱讀進度點觸發事件
- 結合其他頁面元素（如目錄）進行交互

### 2. 與內容載入集成

Astro 的 Content Loader API 允許你從各種來源載入數據。你可以將進度條與內容載入狀態集成，提供更完整的用戶體驗反饋。

### 3. 響應式設計調整

進度條可以根據不同設備尺寸自動調整：
- 在移動設備上可能需要更細的進度條
- 在大屏幕上可以添加更多視覺元素
- 可以使用 Tailwind 的響應式類實現這些調整

## 結論

![rahul-mishra-XXMA-8fBB-g-unsplash.avif](https://assets.calpa.me/rahul-mishra-XXMA-8fBB-g-unsplash.avif)

通過 Astro 框架實現滾動進度條是一個展示其強大功能和優勢的絕佳案例。這個簡單但實用的 UI 元素利用了 Astro 的性能優先設計、島嶼架構和簡化的開發體驗。代碼簡潔直觀，性能出色，並且可以輕鬆地與各種網站設計集成。

隨著 Astro 框架的不斷發展，我們可以期待更多優化和功能，使類似進度條這樣的 UI 元素實現變得更加簡單和高效。無論是對內容豐富的靜態網站還是需要一定動態功能的網站，Astro 都提供了一個平衡性能和功能的絕佳解決方案。

對於前端開發者而言，熟悉 Astro 及其實現方式將成為打造高性能、用戶友好網站的重要技能。這個簡單的進度條實現是掌握這一強大框架的良好起點。
