v0.21

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 なし はい ツールチップが閉じたときに送出

動作仕様