Vibe Design Tips

オーバーレイの選び方

009 Overlays

オーバーレイの選び方

コンポーネントインタラクション

ツールチップ、カーソルチップ、ポップコンファーム、ダイアログ、ドロワー、独立したページは、それぞれどんな場面に向いているか。

多くの管理画面系プロダクトでは、どこでもダイアログを使います。はてなアイコンの説明、アーカイブ前の確認、編集フォームなど、毎回まずダイアログを処理しないと先に進めません。ツールチップはほとんど操作を妨げませんが、ダイアログはページ全体を覆います。よく使うオーバーレイは次のとおりです:

  1. ツールチップ(Tooltip):ポインタが指している内容を文字で補足します。表の長いファイル名のように、切り詰められた長いテキストによく使います。ポインタが離れると消えるので、文字だけを置きます。ボタンやリンクを置くなら、クリックで開くポップオーバー(Popover)を使います。
  2. カーソルチップ(Cursor tip):ある領域全体で継続して情報を示します。グラフや比較的独立した要素によく使います。ポインタが入ったときだけ表示され、ポインタに追従します。たとえば折れ線グラフで、指しているデータ点の日付と値を表示します。
  3. ポップコンファーム(Popconfirm):コメントの削除など、取り消せない操作の大半に使います。確認ボックスがボタンの横に表示されるので、視線を動かさずに済み、手順も短く、邪魔になりません。
  4. ダイアログ(Dialog):プロジェクト全体の完全削除のように、影響が大きい確認、一括操作の確認、ユーザーに立ち止まって考えてもらう必要がある確認に使います。ファイル名の変更のように、短くてページのほかの情報を参照する必要のないフォームにも使います。
  5. ドロワー(Drawer):長いフォームや、顧客リストの横で特定の顧客の情報を編集するなど、入力中にページの内容と見比べる必要がある場合に使います。ドロワーは横からスライドして出てくるので、メインのページは見えたままで、ワイド画面の横方向のスペースもうまく使えます。
  6. 独立したページ:新規プロジェクト作成時の詳細な設定のように、フォームそのものが主な作業である場合は独立したページにし、固有のアドレスと戻る経路を持たせます。

なお、アーカイブのように取り消せる操作には確認は不要です。すぐに実行し、「元に戻す」の入口を残します。スマートフォンでは、ツールチップとカーソルチップはどちらもタップで表示するようにします。

付属の Prompt は、まずプロダクト内のすべてのオーバーレイを洗い出し、1つずつどれを使うべきか判断して表にまとめ、あなたに決めてもらいます。確認後は同意した部分だけを変更し、見た目のスタイルはそのまま保ちます。

PromptClaude Code や Cursor などのエージェントに貼り付けて使えます
Review how my product uses floating UI (tooltips, tooltips that follow the pointer, popovers, popconfirms, drawers and dialogs) and decide which kind each case should be. Work inside my existing design system. This is about choosing the right kind, not about restyling: keep my components, colours, radii, shadows, fonts, motion and copy style.

0. Start from what exists
- Find every overlay in the product and the components behind it: tooltips, hover cards, popovers, confirm bubbles, menus that confirm, side panels, drawers, sheets, modals and dialogs.
- For each use, note where it is, what opens it, what it holds and what happens when the user confirms.
- Find the design system's own component for each kind. Reuse it. If two components do the same job, say so and suggest which one to keep.

1. What each kind is for
- Tooltip: adds text about what the pointer is on, such as long text that has been cut short, an icon-only button or a disabled control. Text only. If it needs actions, it becomes a popover opened by a click.
- Tooltip that follows the pointer: keeps giving information across an area. It appears when the pointer enters, follows it, and goes when the pointer leaves. Common on charts and on other self-contained elements.
- Popconfirm: the second check for an irreversible action on a single item, right where it was clicked. The path stays short and nothing else is interrupted.
- Dialog: for something the user must stop and confirm or complete before going on: an action with a large impact, one that affects other people, a bulk action, or one that needs another decision first (such as who takes over the projects). Also for a short form that doesn't need anything else on the page for reference.
- Drawer: for a long form, for work that needs the page in view to compare against, or to make better use of horizontal space. Never use a drawer to confirm something.
- Full page: when the task is the user's main job there, or it needs a link that can be shared and survives a reload.

2. Questions that settle a case
- Can the action be undone? Then don't confirm: do it at once and offer Undo (a toast, or a way back such as a trash).
- If it can't: is it one item of the user's own, with a button to anchor to? Popconfirm. Large impact, other people, a bulk selection, or a decision still to make? Dialog.
- Is it a form? Short, and nothing on the page is needed for reference: dialog. Long, needs the page in view, or wants the width: drawer. The main task, or needs its own URL: a page.
- Is the information about one element, or about wherever the pointer is inside an area? One element: tooltip. An area: tooltip that follows the pointer. Either way, does it need anything to click? Then it is a popover.
- On touch screens there is no hover: anything shown on hover must also be reachable by a tap.

3. What each kind should do
Fill in only what is missing, with the design system's existing parts.
- Tooltip: shows on hover and on keyboard focus, after about 500ms for the first one, then at once when moving to a neighbour. Stays inside the viewport, lets the pointer through, one at a time, linked with aria-describedby.
- Tooltip that follows the pointer: sits beside the pointer without covering it and flips near the edges of the viewport. On a chart, the guide line follows the pointer and the value snaps to the nearest data point. On touch, a tap shows the value.
- Popconfirm: anchored to the button that opened it and grows from it. Escape or a click outside closes it, and focus goes back to that button. The confirm button names the action.
- Dialog: the system's modal or a native dialog opened with showModal(). Keeps focus inside and Escape cancels. It says who or what is affected and what cannot be undone. Buttons name the action ("Remove member", not "OK").
- Drawer: comes in from the edge it is attached to and leaves the page in view. Changes show up in the page behind it as they are made. Closes with Escape and a close button; focus moves into it and back out to what opened it.
- Drawers, dialogs and pages with a form: closing with unsaved changes asks first.

4. Keep the design as it is
- Change only the kind where the current one is wrong, plus the missing behaviour from step 3.
- Don't change colours, radii, shadows, fonts, spacing or animations, and don't add new visual patterns.
- Keep copy as it is, except confirm buttons and the line that explains what cannot be undone.
- If a case needs a component the system doesn't have (an undo toast, a popover), stop and ask me before adding one.

5. Deliver the decisions first
- Before changing any code, give me a table: each use, where it is, its current kind, the kind you recommend, and why in one line.
- Mark the ones that are already right, and the ones that could fit two kinds, with what decides between them.
- Wait for my go-ahead, then make only the changes I approve and list every file you touched.