LESSON-27 · solution
這一頁不是直接複製答案；先逐檔看差異、修改原因與驗收證據，再把需要的改動帶回自己的資料夾。 這頁用 可觀察證據 和 anchor 指出下一個動作。
這一頁的結果：所有相關檔案可開啟或閱讀；沒有 TODO、CHECKPOINT 或 placeholder；能說明每個檔案為何改動
工作方式：先把這一階段複製到自己的工作資料夾，開啟 files/index.html，記下修改前的畫面、DOM、Console 或 Network狀態。
會用到的檔案：index.html、style.css、main.js、services.html、about.html、contact.html、Code.gs
本堂焦點：串起 Google Sheet 寫入與表單完整狀態流程
一次只做一張卡。完成後先重新整理入口，再留下證據，才進入下一張。
現在要做：先對照差異，再檢查 在 main.js 的「status flow」對照這項變更：function setStatus(state, message) {
status.dataset.state = state;
status.textContent = message;
}
setStatus("idle", "尚未送出");
貼上位置：main.js 的 status flow 區塊
function setStatus(state, message) {
status.dataset.state = state;
status.textContent = message;
}
setStatus("idle", "尚未送出");預期結果：按送出後狀態依序變更，成功與錯誤都能說明。
驗收證據：status 文字、button disabled 與 Console。
常見錯誤：只複製完整答案，卻沒有先理解這一項差異的責任。
第一個檢查：只對照目前差異指定的檔案與 anchor。
現在要做：先對照差異，再檢查 在 Code.gs 的「appendRow reference」對照這項變更：const row = [new Date(), payload.name, payload.message];
// 正式環境才由 SpreadsheetApp 寫入指定 Sheet。
貼上位置：Code.gs 的 appendRow reference 區塊
const row = [new Date(), payload.name, payload.message];
// 正式環境才由 SpreadsheetApp 寫入指定 Sheet。預期結果：Code.gs 能說明 timestamp、name、message 的欄位順序。
驗收證據：Code.gs 欄位順序與前端 payload 對照。
常見錯誤：只複製完整答案，卻沒有先理解這一項差異的責任。
第一個檢查：只對照目前差異指定的檔案與 anchor。
現在要做：先對照差異，再檢查 在 main.js 的「mock request」對照這項變更：setStatus("loading", "寫入中，請稍候");
action.disabled = true;
window.setTimeout(() => { action.disabled = false; setStatus("success", "mock 寫入成功，未修改正式 Sheet"); }, 300);
貼上位置：main.js 的 mock request 區塊
setStatus("loading", "寫入中，請稍候");
action.disabled = true;
window.setTimeout(() => { action.disabled = false; setStatus("success", "mock 寫入成功，未修改正式 Sheet"); }, 300);預期結果：送出中時按鈕停用，完成後成功或失敗狀態可見。
驗收證據：畫面狀態順序、按鈕 disabled 與沒有正式 Network 寫入。
常見錯誤：只複製完整答案，卻沒有先理解這一項差異的責任。
第一個檢查：只對照目前差異指定的檔案與 anchor。
現在要做：先對照差異，再檢查 在 main.js 的「finally-like reset」對照這項變更：action.disabled = false;
貼上位置：main.js 的 finally-like reset 區塊
action.disabled = false;預期結果：成功或失敗後都可以重新送出。
驗收證據：按鈕狀態與第二次操作結果。
常見錯誤：只複製完整答案，卻沒有先理解這一項差異的責任。
第一個檢查：只對照目前差異指定的檔案與 anchor。
完整檔案收在可展開的卡片中；先完成上方微步驟，再用這裡查閱與複製。檔案位置要和目前的相對路徑一致。
index.html入口檔案：從這份 HTML 開始觀察本堂主題結果。style.css呈現層：只放本堂實作需要觀察的 CSS 規則。main.js行為層：處理本堂操作、狀態與 Console 驗收訊息。services.html服務頁：集中說明服務內容與方案比較。about.html關於頁：說明商家背景與服務方式。contact.html聯絡頁：提供表單欄位與狀態流程。Code.gs離線參考：Apps Script Web App 的 mock 回應，不連正式服務。index.html入口檔案：從這份 HTML 開始觀察本堂主題結果。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>功能實作：Google Sheet 與完整狀態流程</title>
<link rel="icon" href="../../../assets/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="style.css">
</head>
<body>
<header class="site-header"><a class="brand" href="index.html">安心維護</a><nav aria-label="主要導覽"><a href="index.html">首頁</a> <a href="services.html">服務</a> <a href="about.html">關於</a> <a href="contact.html">聯絡</a></nav></header>
<main class="page-shell">
<p class="eyebrow">LESSON-27 · 串起 Google Sheet 寫入與表單完整狀態流程</p>
<h1>功能實作：Google Sheet 與完整狀態流程</h1>
<p class="page-description">串起 Google Sheet 寫入與表單完整狀態流程</p>
<!-- lesson-slot -->
<section class="result-card" aria-labelledby="result-title">
<h2 id="result-title">本堂可觀察結果</h2>
<p id="status" role="status">尚未操作，請依微步驟完成本堂練習。</p>
<button id="action" type="button">執行本堂操作</button>
</section>
</main>
<script src="main.js" defer></script>
</body>
</html>style.css呈現層：只放本堂實作需要觀察的 CSS 規則。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
:root { font-family: system-ui, -apple-system, "Segoe UI", "Noto Sans TC", sans-serif; color: #17324d; background: #f5f8fb; }
* { box-sizing: border-box; }
body { margin: 0; min-height: 100vh; line-height: 1.7; }
.site-header { width: min(100% - 2rem, 920px); margin: 1rem auto 0; padding: .75rem 0; display: flex; justify-content: space-between; gap: 1rem; align-items: center; }
.site-header nav { display: flex; flex-wrap: wrap; gap: .7rem; }
.site-header a { color: #155e75; }
.page-shell { width: min(100% - 2rem, 760px); margin: 2rem auto; padding: 2rem; border: 1px solid #cbd8e4; border-radius: 20px; background: #fff; }
.eyebrow { color: #176b87; font-weight: 800; }
.page-description { color: #52657d; }
.result-card { padding: 1rem; border: 1px solid #d8e0ea; border-radius: 14px; background: #fbfdff; }
button { padding: .65rem .9rem; border: 0; border-radius: 9px; background: #176b87; color: #fff; font: inherit; cursor: pointer; }
button:focus-visible, a:focus-visible { outline: 3px solid #f1ab2c; outline-offset: 3px; }
.status { min-height: 2rem; color: #17643d; }
/* lesson-slot */
@media (max-width: 560px) { .site-header { align-items: flex-start; flex-direction: column; } .page-shell { margin: 1rem auto; padding: 1rem; } h1 { font-size: 1.6rem; } }main.js行為層：處理本堂操作、狀態與 Console 驗收訊息。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
const status = document.querySelector("#status, #baseline-status");
const action = document.querySelector("#action, #baseline-action");
function showResult() {
if (status) status.textContent = "串起 Google Sheet 寫入與表單完整狀態流程：先完成入口操作，再逐步驗收。";
console.log("LESSON-27：入口已執行");
}
function setStatus(state, message) {
status.dataset.state = state;
status.textContent = message;
}
setStatus("idle", "尚未送出");
setStatus("loading", "寫入中，請稍候");
action.disabled = true;
window.setTimeout(() => { action.disabled = false; setStatus("success", "mock 寫入成功，未修改正式 Sheet"); }, 300);
action.disabled = false;
if (action) action.addEventListener("click", showResult);services.html服務頁：集中說明服務內容與方案比較。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>服務方案</title>
<link rel="icon" href="../../../assets/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="style.css">
</head>
<body>
<header class="site-header"><a class="brand" href="index.html">安心維護</a><nav aria-label="主要導覽"><a href="index.html">首頁</a> <a href="services.html">服務</a> <a href="about.html">關於</a> <a href="contact.html">聯絡</a></nav></header>
<main class="page-shell">
<p class="eyebrow">LESSON-27 · 串起 Google Sheet 寫入與表單完整狀態流程</p>
<h1>服務方案</h1>
<p class="page-description">串起 Google Sheet 寫入與表單完整狀態流程</p>
<!-- lesson-slot -->
<section class="service-grid"><article class="service-card"><h2>到府諮詢</h2><p>先釐清訪客需求。</p></article><article class="service-card"><h2>定期維護</h2><p>建立穩定的服務節奏。</p></article></section>
</main>
<script src="main.js" defer></script>
</body>
</html>about.html關於頁：說明商家背景與服務方式。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>關於商家</title>
<link rel="icon" href="../../../assets/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="style.css">
</head>
<body>
<header class="site-header"><a class="brand" href="index.html">安心維護</a><nav aria-label="主要導覽"><a href="index.html">首頁</a> <a href="services.html">服務</a> <a href="about.html">關於</a> <a href="contact.html">聯絡</a></nav></header>
<main class="page-shell">
<p class="eyebrow">LESSON-27 · 串起 Google Sheet 寫入與表單完整狀態流程</p>
<h1>關於商家</h1>
<p class="page-description">串起 Google Sheet 寫入與表單完整狀態流程</p>
<!-- lesson-slot -->
<section><h2>我們如何協助</h2><p>先理解現場，再提出可執行的服務方案。</p></section>
</main>
<script src="main.js" defer></script>
</body>
</html>contact.html聯絡頁：提供表單欄位與狀態流程。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
<!doctype html>
<html lang="zh-Hant">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>聯絡與諮詢</title>
<link rel="icon" href="../../../assets/favicon.svg" type="image/svg+xml">
<link rel="stylesheet" href="style.css">
</head>
<body>
<header class="site-header"><a class="brand" href="index.html">安心維護</a><nav aria-label="主要導覽"><a href="index.html">首頁</a> <a href="services.html">服務</a> <a href="about.html">關於</a> <a href="contact.html">聯絡</a></nav></header>
<main class="page-shell">
<p class="eyebrow">LESSON-27 · 串起 Google Sheet 寫入與表單完整狀態流程</p>
<h1>聯絡與諮詢</h1>
<p class="page-description">串起 Google Sheet 寫入與表單完整狀態流程</p>
<!-- lesson-slot -->
<form id="contact-form"><label for="name">姓名</label><input id="name" name="name" required><label for="message">需求</label><textarea id="message" name="message" required></textarea><button id="action" type="submit">送出 mock</button><p id="status" role="status">尚未送出</p></form>
</main>
<script src="main.js" defer></script>
</body>
</html>Code.gs離線參考：Apps Script Web App 的 mock 回應，不連正式服務。這段要貼在哪裡：先在自己的工作資料夾建立同名相對位置，再複製內容。
function doPost(e) {
const payload = JSON.parse(e.postData.contents);
const row = [new Date(), payload.name, payload.message];
// 正式環境才由 SpreadsheetApp 寫入指定 Sheet。
return ContentService.createTextOutput(JSON.stringify({ ok: true, received: payload })).setMimeType(ContentService.MimeType.JSON);
}Solution 對照完成後，回到 README 整理證據，並準備下一堂課的先備知識。