商用網站架設實務

LESSON-27 · checkpoint

功能實作:Google Sheet 與完整狀態流程

主要結構已經完成,只留下本堂一個核心缺口。先預測,再從指定檔案找出它。 這頁用 可觀察證據anchor 指出下一個動作。

Starter3 個小成果
Checkpoint一個核心缺口
Solution4 個差異

開始前確認

這一頁的結果:入口頁可以開啟

工作方式:先把這一階段複製到自己的工作資料夾,開啟 files/index.html,記下修改前的畫面、DOM、Console 或 Network狀態。

會用到的檔案:index.htmlstyle.cssmain.jsservices.htmlabout.htmlcontact.htmlCode.gs

本堂焦點:串起 Google Sheet 寫入與表單完整狀態流程

照這個順序做

一次只做一張卡。完成後先重新整理入口,再留下證據,才進入下一張。

CHECKPOINT-1

避免一次失敗後表單永遠不能再操作。

目的

避免一次失敗後表單永遠不能再操作。

修改檔案

main.js

程式碼位置

finally-like reset

現在要做:請在 main.js 的「finally-like reset」位置完成:在 mock 完成後解除送出按鈕 disabled

貼上位置:main.js:finally-like reset 區塊,先保留同一檔案的其他內容。

action.disabled = false;

預期結果:成功或失敗後都可以重新送出。

驗收證據:按鈕狀態與第二次操作結果。

卡住時先看這裡

常見錯誤:只在成功分支解除 disabled。

第一個檢查:只檢查所有完成分支是否都有 action.disabled=false。

階段檔案

完整檔案收在可展開的卡片中;先完成上方微步驟,再用這裡查閱與複製。檔案位置要和目前的相對路徑一致。

開啟 checkpoint 的可執行入口

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);
// CHECKPOINT-1:請在 main.js 的「finally-like reset」位置完成:在 mock 完成後解除送出按鈕 disabled
// 本堂缺口:mock 完成後按鈕仍 disabled,無法重新操作。
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);
}

完成驗收

下一步

Checkpoint 完成後,先說出你修正的原因,再前往 Solution 對照每個檔案差異。

前往 Solution,逐檔對照差異