懶人包
- 叫 AI 做介面只說「彈窗」,它至少要在 Modal、Popover、Tooltip、Toast 四種元件裡猜;四種的差別在會不會擋住頁面、能不能放按鈕、怎麼出現和消失。
- 我用同一個待辦頁需求,4 種寫法、Claude Haiku/Sonnet/Opus 各生成 3 次,共 36 頁,用 Playwright 實際點擊判分。
- 只說「跳出視窗」的 36 項只對 21 項;只寫元件名、白話描述行為、元件名加一句行為,三種寫法都是 36/36。
- 錯誤集中在兩處:點頭像的資訊卡和「已新增」提示被做成整頁 Modal。刪除確認和滑過說明本來就符合 Modal、Tooltip 的預設,沒有出錯。
- 不記元件名也可以,把「擋不擋頁面、貼在哪、何時消失」講清楚就有同樣效果;元件名加一句行為最短,我的提示詞 860 bytes,白話版 1082 bytes。
- 樣本只有一個需求、Claude 一家三個模型、每格 3 次,能說明「模糊寫法會被預設成 Modal」,不能證明「學元件名能強十倍」。
Instagram 帳號「產品經理的背後靈 Philo」(@cs2pm_ghost)2026-11-07 發了一支 Reel,主張叫 AI 做介面時別只說「彈窗」。作者自己測了 9 次,結果是 3 分對 4 分,也誠實寫了樣本太小。
我想知道兩件事:把實驗放大到 36 頁、換三個模型,結論還站得住嗎?錯的時候錯在哪裡?下面是實測過程、數字和可以直接照抄的寫法。
叫 AI 做「彈窗」時,它要在哪幾種元件裡選?
截圖取自 原始 Reel 的公開頁面,2026-11-10 未登入狀態,532 讚、166 則留言。畫面整片偏暗,是因為 Instagram 對未登入訪客跳出了一個註冊 Modal,把整頁蓋住了。
Reel 裡的四種元件定義來自 The Component Gallery,這是 Iain Bean 整理各家 design system 元件的個人專案。我在 2026-11-10 重新讀了四個元件頁,整理如下:
| 元件 | Component Gallery 的定義(我的翻譯) | 會擋住頁面嗎 | 適合放什麼 |
|---|---|---|---|
| Modal | 出現在其他內容上方,使用者要先跟它互動,才能回到底下的頁面 | 會 | 刪除確認、必填表單 |
| Popover | 從某個元素彈出、蓋在內容上;和 Tooltip 不同,通常是點擊觸發,可以放可互動的元素 | 不會 | 頭像資訊卡、小選單 |
| Tooltip | 顯示元素的說明或額外資訊,通常是滑過觸發,也可以是點擊或觸控 | 不會 | 圖示說明、欄位提示 |
| Toast | 一種出現在其他內容上方的提示,外觀像手機或桌面的推播通知 | 不會 | 「已儲存」「已新增」這類回饋 |
我怎麼測:同一個頁面、4 種寫法、3 個模型
需求固定是一個待辦清單頁,有頭像、新增按鈕、刪除按鈕和說明圖示,各要一個「跳出來」的互動。4 種寫法的共同部分一字不差,連測試要用的元素 id 都寫死,只有最後 4 條互動描述不同:
# 寫法 A:只說「跳出視窗」
1. 點頭像時跳出視窗,顯示姓名、職稱和「傳訊息」按鈕。
2. 按刪除時跳出視窗確認,確認後才刪除。
3. 新增待辦成功後跳出視窗告訴使用者「已新增」。
4. 滑鼠移到說明圖示時跳出視窗,顯示「按 Enter 也可以新增」。
# 寫法 B:只寫元件名
1. 點頭像開 Popover,顯示姓名、職稱和「傳訊息」按鈕。
2. 按刪除時開 Modal 確認,確認後才刪除。
3. 新增待辦成功後顯示 Toast「已新增」。
4. 說明圖示加 Tooltip,內容「按 Enter 也可以新增」。
# 寫法 C:白話描述行為,不出現任何元件名
1. 點頭像時,在頭像正下方貼著出現一個小面板,不遮住頁面其他部分,裡面顯示姓名、職稱和「傳訊息」按鈕;點面板外面就收起。
2. 按刪除時,整頁變暗蓋上一層,中間出現確認框,使用者必須按確認或取消才能回到頁面,確認後才刪除。
3. 新增待辦成功後,在畫面角落浮出「已新增」小提示,約 3 秒後自己消失,不需要使用者點。
4. 滑鼠移到說明圖示時,旁邊浮出一行小字「按 Enter 也可以新增」,滑鼠移開就消失。
# 寫法 D:元件名加一句行為
1. 點頭像開 Popover,貼在頭像下方,顯示姓名、職稱和「傳訊息」按鈕。
2. 按刪除時開 Modal,必須按確認或取消才能回到頁面,確認後才刪除。
3. 新增待辦成功後顯示 Toast「已新增」,3 秒後自動消失。
4. 說明圖示加 Tooltip,滑過顯示「按 Enter 也可以新增」。
生成用 Claude Code 的非互動模式,關掉所有工具,只讓模型輸出一個 HTML 檔:
claude -p --model opus --tools "" < prompts/vague.txt > out/opus_vague_1.html.raw
haiku、sonnet、opus 三個別名在 2026-11-10 分別對應 claude-haiku-5-5、claude-sonnet-5-5、claude-opus-5-5,這是用 --output-format json 回傳的 modelUsage 確認的。每個模型、每種寫法各生成 3 次,總共 36 頁。
判分不靠肉眼。我寫了一支 Python 程式,用 Playwright 打開每一頁,實際去點、去滑,看出現的東西符不符合預期元件的行為:
| 互動 | 預期元件 | 程式怎麼判定通過 |
|---|---|---|
| 點頭像 | Popover | 出現含姓名、職稱、「傳訊息」的面板,沒有整頁遮罩,面板離頭像 120px 以內 |
| 按刪除 | Modal | 出現整頁遮罩、dialog:modal 或瀏覽器原生 confirm,而且確認前清單沒被刪 |
| 新增待辦 | Toast | 出現「已新增」,不帶遮罩、不是 alert,6 秒內自己消失 |
| 滑過說明圖示 | Tooltip | 滑過出現、移開消失,或用原生 title 屬性 |
position 為 fixed 或 absolute、蓋住 90% 以上視窗的元素:
window.__overlays = () => document.querySelectorAll('dialog:modal').length
+ [...document.querySelectorAll('body *')].filter(el => {
if (!__vis(el)) return false;
const pos = getComputedStyle(el).position;
if (pos !== 'fixed' && pos !== 'absolute') return false;
const r = el.getBoundingClientRect();
const w = Math.min(r.right, innerWidth) - Math.max(r.left, 0);
const h = Math.min(r.bottom, innerHeight) - Math.max(r.top, 0);
return w * h >= 0.9 * innerWidth * innerHeight;
}).length;
正式跑之前,我先手寫兩個對照頁驗證判分程式:四種元件都做對的頁面拿 4/4,全部做錯的拿 0/4。
結果:只說「跳出視窗」21/36,其他三種寫法都 36/36
每格是 3 次生成各自的分數,滿分 4:
| 寫法 | Haiku | Sonnet | Opus | 合計 |
|---|---|---|---|---|
| A 只說「跳出視窗」 | 2, 2, 2 | 2, 2, 2 | 2, 4, 3 | 21/36 |
| B 只寫元件名 | 4, 4, 4 | 4, 4, 4 | 4, 4, 4 | 36/36 |
| C 白話描述行為 | 4, 4, 4 | 4, 4, 4 | 4, 4, 4 | 36/36 |
| D 元件名加一句行為 | 4, 4, 4 | 4, 4, 4 | 4, 4, 4 | 36/36 |
| 寫法 A 的互動 | 做對的頁數 | 做錯時長什麼樣 |
|---|---|---|
| 點頭像 → 應為 Popover | 2/9 | 整頁變暗,資訊卡離頭像 189–510px,不是貼在頭像旁 |
| 按刪除 → 應為 Modal | 9/9 | — |
| 新增待辦 → 應為 Toast | 1/9 | 整頁變暗,「已新增」出現在遮罩上的提示框裡 |
| 滑過說明 → 應為 Tooltip | 9/9 | — |
左邊兩格是寫法 A 的實際輸出,右邊是寫法 B、D 的實際輸出,全部是判分時 Playwright 截下來的畫面。
Opus 在寫法 A 也錯了 3 項,所以這不是小模型才會犯的錯。Haiku 和 Sonnet 的 6 頁錯法完全一樣:頭像和新增提示都做成 Modal。
為什麼刪除確認和滑過說明沒有做錯?
這次 9 頁裡,模型把「跳出視窗」做成 Modal 的情況最多,而刪除確認本來就該用 Modal。需求和模型的選擇剛好重疊,所以 9/9。
滑過說明也是同理。需求寫了「滑鼠移到說明圖示時」,觸發方式已經講明是滑過,9 頁都做成滑過出現、移開就消失的提示。
出錯的兩個互動,需求都沒交代「擋不擋頁面」和「何時消失」。點頭像只說了「跳出視窗」,新增成功也只說「告訴使用者」,做錯的頁面都選了整頁遮罩加中間的對話框。
這也是 Reel 作者那 9 次實驗看到的現象。他的 3 分和 4 分差在點頭像這一項,我的實驗多看到了新增提示這一項。
一定要背元件名嗎?白話描述行為也可以
寫法 C 一個元件名都沒出現,9 頁 36 項全對。所以真正起作用的是「把行為講清楚」,元件名只是最短的講法。
三種全對的寫法,差別在長度。整份提示詞的 UTF-8 大小:
| 寫法 | 檔案大小 | 4 條互動的寫法 |
|---|---|---|
| B 只寫元件名 | 772 bytes | 每條一個元件名 |
| D 元件名加一句行為 | 860 bytes | 元件名+位置或消失時機 |
| C 白話描述行為 | 1082 bytes | 每條描述遮罩、位置、關閉方式 |
不知道元件叫什麼時,用 C 的寫法也行。描述時回答三個問題就夠了:
- 會不會擋住頁面,使用者要不要先處理它?
- 出現在哪裡,貼著哪個元素還是畫面角落?
- 怎麼消失:按按鈕、點外面、滑鼠移開,還是幾秒後自己消失?
這個實驗的限制,和判分時踩過的坑
先講限制:
- 只有一個需求:一個待辦頁、四個互動。換成表單、儀表板,錯的位置可能不一樣。
- 只測了 Claude:Haiku、Sonnet、Opus 三個模型都是同一家,GPT、Gemini 會不會一樣預設成 Modal,我沒測。
- 每格只跑 3 次:B、C、D 都 36/36,只能說在這個需求上沒看到差別,不代表永遠不會錯。
- 「十倍」沒有被證明:Reel 引用了 Andrew Gao 在 X 的兩則貼文,說先學 UI 元件名、用 AI 做前端能強十倍。我未登入讀不到貼文內容,只能看到 Reel 的轉述;這次實驗量的是「四個互動做對幾個」,跟「十倍」不是同一件事。
- 淡出動畫的文字被當成還在:有些頁面的 Tooltip 移開後只是
opacity: 0,元素還在 DOM 裡。用外層容器的textContent找字,會判成「移開仍在」。改成找最小的那個含字元素,並用checkVisibility({ opacityProperty: true })判斷可見。 - 原生
<dialog>的遮罩抓不到:用showModal()開的對話框,遮罩是::backdrop偽元素,不是一般 DOM 元素,掃position: fixed找不到。改成另外數dialog:modal。
照做的寫法:四種元件的提示詞範本
把下面四行改成你的元素和內容,貼進需求裡:
點頭像開 Popover,貼在頭像下方,放姓名、職稱和「傳訊息」按鈕。
按刪除時開 Modal,必須按確認或取消才能回到頁面,確認後才刪除。
儲存成功後顯示 Toast「已儲存」,3 秒後自動消失。
說明圖示加 Tooltip,滑過顯示「按 Enter 也可以新增」。
AI 交回來之後,用這四件事檢查,不必讀程式碼:
| 元件 | 動手檢查 |
|---|---|
| Popover | 打開後還能捲動、點得到頁面其他地方;面板貼在觸發它的元素旁邊 |
| Modal | 打開後頁面變暗,點不到底下的按鈕;不按確認或取消就關不掉 |
| Toast | 不用按任何東西,幾秒後自己消失;出現期間還能繼續操作 |
| Tooltip | 滑鼠移上去出現,移開就消失;裡面只有說明文字 |
延伸資源
- The Component Gallery:元件名稱字典,每個元件列出各家 design system 的實作與別名,忘記某個介面叫什麼時查這裡。
- 四元件互動小字典與實測數據:我把這次的四種元件做成可以點的示範頁,附 36 頁的結果表。
- web.dev:Popover and dialog:瀏覽器原生的
popover屬性和<dialog>怎麼對應這幾種元件。 - apple-design skill 實測:讓 Claude Code 寫介面時套用一致的動效與材質規範。
- emil-design-eng skill 實測:審查元件開關動畫的時長與曲線。