ALL NOTES

LAB NOTES / 2026.10.04

DAY 21|數據統計:任務列表進度條與時間呈現

在 Day 20 完成了 CRUD 的連動渲染後,接下來要處理「數據視覺化」與「時間統計」的功能,讓使用者一眼就能掌握各個任務的完成進度與累積花費時間。


進度與時間計算函式

1. 進度百分比計算(calculateTaskProgress)

計算該主任務下已完成(completed)的子任務比例:

進度百分比計算

總花費時間計算與格式化

統計每一個子任務歷史紀錄(records)中的分鐘數,並轉換成方便閱讀的字串格式(例如:2 天 3 小時 15 分鐘)。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// 計算主任務累積總分鐘數
function getMainTaskTotalMinutes(task) {
if (!task.subtasks) return 0;
return task.subtasks.reduce((total, sub) => {
const subTotal = sub.records ? sub.records.reduce((acc, r) => acc + r.durationMinutes, 0) : 0;
return total + subTotal;
}, 0);
}

// 分鐘數轉可讀字串 (例: 135 分鐘 -> 2 小時 15 分鐘)
function formatMinutesToReadableText(totalMinutes) {
if (totalMinutes === 0) return "0 分鐘";
const hours = Math.floor(totalMinutes / 60);
const mins = totalMinutes % 60;
return `${hours > 0 ? hours + ' 小時 ' : ''}${mins} 分鐘`;
}

二、整合至 Accordion 標頭(Header)

計算好數據後,我們在產出 Accordion 的 HTML 時,將 Bootstrap 的 Progress Bar 與時間標籤動態帶入:

  1. Bootstrap Progress Bar:利用內建的 .progress 與 .progress-bar,將計算出來的進度百分比賦予到 CSS width 屬性。當進度達 100% 時,亦可將樣式切換為綠色(bg-success)。

  2. 總計時間標記:在主任務標題旁顯示整體累積花費時間。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
// Accordion Item
const progress = calculateTaskProgress(task);
const readableTotalTime = formatMinutesToReadableText(getMainTaskTotalMinutes(task));

const headerHTML = `
<div class="row w-100 align-items-center">
<div class="col-md-4">
<span class="fw-bold">${task.title}</span>
</div>
<div class="col-md-8 d-flex align-items-center">
<!-- Bootstrap 進度條 -->
<div class="progress me-3 w-100" style="height: 18px;">
<div class="progress-bar ${progress === 100 ? 'bg-success' : 'bg-primary'}"
style="width: ${progress}%">
${progress}%
</div>
</div>
<!-- 總花費時間 -->
<span class="text-nowrap text-secondary fs-sm">總計:${readableTotalTime}</span>
</div>
</div>
`;

三、展開歷史紀錄

除了主任務的整體統計外,當使用者點擊子任務內的「檢視計時與備註紀錄」時,會展開隱藏的子區塊(Collapse),列出該子任務每次計時的時間區段與紀錄備註,使用者可以視需求查看。


任務清單連動完成

所有筆記