Coach marks 新手引导
/KOHCH MARKS/ · noun · 浮层类模式 · #119
第一次使用 App 时指向界面某个部分的简短提示，常常把屏幕其余部分压暗、只把一个按钮“打光”突出，说明它的用途，点“下一步”或“知道了”继续。连成一串就是产品导览。它应该简短、可以跳过，关掉后不再出现。
别名：功能引导气泡、app新手引导。
你可能会这样叫它
- “第一次打开 App 时指着按钮的提示”
- “屏幕变暗只亮一个按钮的引导”
- “App 里的教学气泡”
- “新功能的分步介绍”
……它的名字是 新手引导（Coach marks）。
常见问题
新手引导怎么做？
常见做法是功能引导气泡（coach marks）：第一次进入时压暗屏幕，只突出一个按钮，旁边用一句话说明它的用途，点“下一步”或“知道了”继续。一次只讲一两个不显眼的功能，可以跳过，关掉后不再出现；需要讲太多，说明界面本身该改了。
代码里叫什么
| SwiftUI (TipKit) | Tip TipView .popoverTip(_:) |
|---|---|
| UIKit / AppKit (TipKit) | TipUIView TipNSView |
| Android / Compose | 系统没有现成组件：自己画带镂空的压暗遮罩，或用引导库 |
| Web | popover attribute anchor-name Shepherd.js、Driver.js 等引导库负责压暗和镂空 |
复制给 AI 编程工具
为第一次使用这个界面的用户加上新手引导：最多三步，每步是一个带箭头的气泡，用一句话说明箭头所指的控件；除这个控件外，屏幕其余部分压暗；带“下一步”“跳过”和步骤计数。只显示一次，按用户记住已关闭，绝不打断用户已经开始的操作，每条提示事后在帮助里也能找到。