On this page
d-tooltip
要素がホバーまたはキーボードフォーカスを受け取ったときに関連情報を表示する軽量なポップアップです。トップレイヤーのd-popover配置エンジンを基盤とし、統合されたキーボードショートカット表示や無効化トリガーボタンへの安全な対応を備えています。
1<d-tooltip text="save document" shortcut="cmd+s" side="top">2 <button class="btn btn-outline">save</button>3</d-tooltip>4 5<d-tooltip text="action unavailable" side="right">6 <button class="btn btn-outline" disabled>disabled action</button>7</d-tooltip>8 9<d-tooltip>10 <button slot="trigger" class="btn btn-gray"><i class="dstrn-add-line"></i></button>11 <span slot="content">custom tooltip markup</span>12</d-tooltip>
属性とプロパティ
| 属性 | プロパティ | 型 | デフォルト値 | フォーム | 説明 |
|---|---|---|---|---|---|
text |
text |
string |
"" |
いいえ | ツールチップのテキスト内容 |
shortcut |
shortcut |
string |
"" |
いいえ | <d-key>によって自動表示されるキーボードショートカット(例: "cmd+s", "alt+left") |
side |
side |
string |
"top" |
いいえ | 推奨配置位置("top", "bottom", "left", "right", "inline-start", "inline-end") |
align |
align |
string |
"center" |
いいえ | トリガー軸に沿った整列("start", "center", "end") |
delay |
delay |
number |
150 |
いいえ | 表示までのホバー猶予遅延ミリ秒 |
offset |
offset |
number |
6 |
いいえ | トリガーとツールチップバブル間のピクセル間隔 |
disabled |
disabled |
boolean |
false |
いいえ | ツールチップの表示を無効化 |
プログラム用api
1const tip = select('d-tooltip');2 3tip.open();4tip.close();5tip.toggle();6tip.setAnchor(select('#custom-anchor'));7const anchor = tip.getAnchor();8tip.text = 'new label';9tip.disabled = true;10 11// アクティブなすべてのツールチップを閉じる12dTooltip.closeAll();
イベント
| イベント | 詳細 | バブリング | 説明 |
|---|---|---|---|
open |
なし | はい | ツールチップが表示されたときに送出 |
close |
なし | はい | ツールチップが閉じたときに送出 |
動作仕様
d-popoverを介してブラウザのトップレイヤーにレンダリングされるため、親要素のoverflow: hiddenによるクリッピングやz-indexスタッキングコンテキストの影響を受けません。shortcut指定時は自動的にプラットフォーム対応の<d-key>バッジをレイアウトします。- 外側ラッパー経由でポインターイベントを処理するため、無効化されたボタン上でも確実にツールチップを表示します。
- キーボード操作に対応し、
focusinで表示されfocusoutで非表示になります。

