AI 教學 16 min read

AI 做介面別只說「彈窗」:36 頁實測 Modal、Popover、Toast 寫法

叫 AI 做介面只說「彈窗」,它要在 Modal、Popover、Tooltip、Toast 四種元件裡猜;我用同一個待辦頁讓 Claude 三個模型生成 36 頁,以 Playwright 實際點擊判分。只說「跳出視窗」對 21/36,寫元件名或白話描述行為都 36/36——講清楚擋不擋頁面、何時消失才是關鍵。

本文目錄 · 8
懶人包
  • 叫 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 做「彈窗」時,它要在哪幾種元件裡選?

產品經理的背後靈 Philo 的 Instagram Reel 頁面截圖,封面寫「叫 AI 做介面 別只說彈窗 它要猜四種元件」,右側貼文列出 Modal、Popover、Tooltip、Toast 的意譯,顯示 532 讚、166 則留言

截圖取自 原始 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一種出現在其他內容上方的提示,外觀像手機或桌面的推播通知不會「已儲存」「已新增」這類回饋
中文說「彈窗」「跳出視窗」,這四種都說得通。差別在三個問題:會不會擋住頁面、能不能在裡面按按鈕、什麼時候自己消失。提示詞沒交代,AI 就只能自己選。

我怎麼測:同一個頁面、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:

寫法HaikuSonnetOpus合計
A 只說「跳出視窗」2, 2, 22, 2, 22, 4, 321/36
B 只寫元件名4, 4, 44, 4, 44, 4, 436/36
C 白話描述行為4, 4, 44, 4, 44, 4, 436/36
D 元件名加一句行為4, 4, 44, 4, 44, 4, 436/36
寫法 A 的 9 頁拆開來看,錯誤只集中在兩個互動:
寫法 A 的互動做對的頁數做錯時長什麼樣
點頭像 → 應為 Popover2/9整頁變暗,資訊卡離頭像 189–510px,不是貼在頭像旁
按刪除 → 應為 Modal9/9—
新增待辦 → 應為 Toast1/9整頁變暗,「已新增」出現在遮罩上的提示框裡
滑過說明 → 應為 Tooltip9/9—
同一個待辦頁的四格對照截圖:左上只說跳出視窗時點頭像變成整頁 Modal,右上寫開 Popover 時是貼在頭像下的小面板;左下只說跳出視窗時新增後跳出要按確定的 Modal,右下寫顯示 Toast 時是角落的「已新增」提示

左邊兩格是寫法 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每條描述遮罩、位置、關閉方式
D 比 C 短約 20%。B 最短,在這次實驗也全對,但它把「貼在哪」「幾秒消失」交給模型決定。我會選 D:名詞讓模型知道是哪一類元件,多一句行為把我在意的細節釘住。

不知道元件叫什麼時,用 C 的寫法也行。描述時回答三個問題就夠了:

  • 會不會擋住頁面,使用者要不要先處理它?
  • 出現在哪裡,貼著哪個元素還是畫面角落?
  • 怎麼消失:按按鈕、點外面、滑鼠移開,還是幾秒後自己消失?

這個實驗的限制,和判分時踩過的坑

先講限制:

  • 只有一個需求:一個待辦頁、四個互動。換成表單、儀表板,錯的位置可能不一樣。
  • 只測了 Claude:Haiku、Sonnet、Opus 三個模型都是同一家,GPT、Gemini 會不會一樣預設成 Modal,我沒測。
  • 每格只跑 3 次:B、C、D 都 36/36,只能說在這個需求上沒看到差別,不代表永遠不會錯。
  • 「十倍」沒有被證明:Reel 引用了 Andrew Gao 在 X 的兩則貼文,說先學 UI 元件名、用 AI 做前端能強十倍。我未登入讀不到貼文內容,只能看到 Reel 的轉述;這次實驗量的是「四個互動做對幾個」,跟「十倍」不是同一件事。
判分程式寫第一版時有兩個錯誤,都是拿實際輸出人工核對時發現的:
  1. 淡出動畫的文字被當成還在:有些頁面的 Tooltip 移開後只是 opacity: 0,元素還在 DOM 裡。用外層容器的 textContent 找字,會判成「移開仍在」。改成找最小的那個含字元素,並用 checkVisibility({ opacityProperty: true }) 判斷可見。
  2. 原生 <dialog> 的遮罩抓不到:用 showModal() 開的對話框,遮罩是 ::backdrop 偽元素,不是一般 DOM 元素,掃 position: fixed 找不到。改成另外數 dialog:modal。
修好後 36 頁全部重跑,再開截圖核對判分理由。

照做的寫法:四種元件的提示詞範本

把下面四行改成你的元素和內容,貼進需求裡:

點頭像開 Popover,貼在頭像下方,放姓名、職稱和「傳訊息」按鈕。
按刪除時開 Modal,必須按確認或取消才能回到頁面,確認後才刪除。
儲存成功後顯示 Toast「已儲存」,3 秒後自動消失。
說明圖示加 Tooltip,滑過顯示「按 Enter 也可以新增」。

AI 交回來之後,用這四件事檢查,不必讀程式碼:

元件動手檢查
Popover打開後還能捲動、點得到頁面其他地方;面板貼在觸發它的元素旁邊
Modal打開後頁面變暗,點不到底下的按鈕;不按確認或取消就關不掉
Toast不用按任何東西,幾秒後自己消失;出現期間還能繼續操作
Tooltip滑鼠移上去出現,移開就消失;裡面只有說明文字

延伸資源

下次叫 AI 做介面,先把需求裡每個「跳出來」換成元件名加一句行為,再用上面那張表點一遍。
author
陳
陳彥彤

AI 工程師 · AI 顧問。Java 後端 8 年、AI 工程師 2 年。AI 內訓 · AI 導入顧問 · 前後端與雲端培訓。

support

覺得文章有用可以到 GitHub 給個 star,或是透過信箱聊聊 AI 內訓、AI 導入顧問或前後端 / 雲端培訓。

related

相關文章

[工程實作] · 12min
平面圖變可走的 3D 房子:Claude 讀圖成 JSON、three.js 長出牆,一案 5,000 美元賣的是什麼
照 Threads 上 3,961 讚的貼文實作「丟平面圖、變出可走的 3D 房子」:Claude 把平面圖讀成 JSON,three.js 依門窗開口擠出牆,做成 54.7 KB 的單檔網頁,可以走、可以撞牆、能一鍵換三種裝潢。10 面牆全對、11 個開口只偏 5 公分——但 5,000 美元是工作室寫實品質的價格,這東西真正的位置是沒有實體可掃的預售屋。
[AI 工具] · 13min
Claude 和 ChatGPT 平面圖轉 3D 差在哪?生圖重畫會改格局,寫程式建模我盲測三輪全對
Threads 上有人拿同一張平面圖比 ChatGPT Pro-6 和 Claude Sonnet 5.5 做 3D:ChatGPT 改了格局、Claude 位置全對,差別在一邊重新生一張渲染圖,一邊寫程式照座標建模。我把讀圖這一步拆出來盲測三輪,18 間房、35 個門窗全對,低解析 JPEG 也一樣——但題目是程式畫的乾淨圖,真實建案圖還沒驗。
[工程實作] · 13min
單鍵遊戲難度怎麼測?只改玩家假設,分數就差 7 倍
「叭!機車瀑布」是我看完 Mr.Rawwww 把牧場糗片做成單鍵遊戲的 Reel 後,借公式做的台灣題材單檔 HTML 遊戲,用 Node 模擬玩家各跑 200 局調難度。同一組關卡只改按鍵誤差,中位數就從 11 分變 80 分——模擬能抓難度曲線壞掉,回答不了好不好玩,這款目前也還沒有真人試玩資料。