「?」アイコンにマウスカーソルを合わせると補足説明が表示される、基本のツールチップの作り方を紹介します。パソコンではホバーで表示され、カーソルを外すと非表示になります。スマートフォンではアイコンをタップして表示し、もう一度タップすると閉じることができます。
今回のデモでは、「項目名」の横にある「?」アイコンを操作すると、黒い背景のツールチップが上側に表示されます。説明文の下には小さな三角形の矢印が付き、どのアイコンに対応する説明なのか分かるデザインになっています。
ツールチップは上側だけでなく、下側・左側・右側にも配置できます。表示する方向に合わせてツールチップ本体と矢印の位置を変更することで、4方向に対応できます。各方向への変更方法は、下記の「ファイル構成と設置方法」で説明します。
HTMLとCSSでツールチップのデザインやホバー時の表示を設定し、JavaScriptでスマートフォンのタップによる開閉を制御します。また、キーボードで「?」アイコンにフォーカスした場合も補足説明を表示できます。
デモ
パソコンでは「項目名」の横にある「?」アイコンへマウスカーソルを合わせると、上側にツールチップが表示されます。カーソルを外すと非表示になります。スマートフォンでは「?」アイコンをタップすると表示され、もう一度タップすると非表示になります。
※ツールチップは上・下・左・右の4方向に配置できます。
各方向への変更方法は、下記の「ファイル構成と設置方法」で詳しく説明しています。
Q 他のアイコンを使いたい場合はどうするの?
無料のSVGアイコン作成ツールを使って、用途に合ったアイコンを作成できます。
コードをコピーして使おう!
<!DOCTYPE html>
<html lang="ja">
<head>
<!-- 文字コードの設定 -->
<meta charset="UTF-8">
<!-- スマートフォンなどの画面幅に対応 -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- ページタイトル -->
<title>基本のツールチップ</title>
<!-- ツールチップのCSSを読み込む -->
<link rel="stylesheet" href="style.css">
</head>
<body>
<!-- ツールチップ全体 -->
<div class="basic-tooltip_wrap">
<!-- 項目名と補足説明アイコン -->
<div class="basic-tooltip_item">
<span class="basic-tooltip_label">
項目名
</span>
<!-- アイコンとツールチップをまとめる領域 -->
<div class="basic-tooltip_area">
<!-- PCではホバー、スマホではタップで操作するアイコン -->
<button class="basic-tooltip_button" type="button" aria-label="項目名の補足説明" aria-describedby="basic-tooltip-message" aria-expanded="false">
?
</button>
<!-- アイコンの上側に表示する補足説明 -->
<div class="basic-tooltip_message" id="basic-tooltip-message" role="tooltip">
ここに項目についての補足説明を表示します。
</div>
</div>
</div>
</div>
<!-- スマートフォンでのタップ開閉処理を読み込む -->
<script src="script.js"></script>
</body>
</html>
コードをコピーする場合 使用するコードのタブを選び、「このタブをコピー」をクリックすると、現在表示中のコードをコピーできます。 サンプル一式を取得する場合 HTML・CSSなどすべてのファイルが必要な場合は、「サンプル一式をダウンロード」をクリックしてください。
Q ダウンロードしたけど、これをネット上で動かすにはどうするの?
Googleアカウントがあれば、InfinityFreeで無料サーバーを作成して、ダウンロードしたサンプルをネット上で動かせます。
InfinityFreeを初めて利用する場合は①から、すでにサーバーを作成している場合は②へ進んでください。
ファイル構成と設置方法
今回のツールチップは、HTML・CSS・JavaScriptの3つのファイルで構成されています。
HTMLでは「項目名」と「?」アイコン、補足説明の文章を配置し、CSSではアイコンのデザイン、ツールチップの表示位置、三角形の矢印、マウスホバー時の表示を設定しています。
JavaScriptでは、スマートフォンで「?」アイコンをタップすると説明が表示され、もう一度タップすると非表示になる処理を行っています。
ツールチップの表示方向は、CSSを変更することで上・下・左・右の4方向に対応できます。
sample/
├── index.html
├── style.css
└── script.js
各ファイルの役割
index.htmlには、項目名を表示するspan要素、「?」アイコンとなるbutton要素、説明文を表示するdiv要素を記述しています。
style.cssでは、アイコンの大きさ・色・枠線、ツールチップの背景色・文字サイズ・表示位置、矢印の形状、ホバー時の表示切り替えを設定しています。
script.jsでは、タッチ操作環境を判定し、アイコンのタップによってツールチップの表示状態を切り替えています。
設置方法・使い方
「サンプル一式をダウンロード」をクリックしてZIPファイルを保存し、展開してください。
sampleフォルダ内のindex.html・style.css・script.jsを同じ階層に配置します。
index.htmlをブラウザで開くと、「項目名」と「?」アイコンが表示されます。
パソコンではアイコンにマウスカーソルを合わせると補足説明が現れ、カーソルを外すと非表示になります。
スマートフォンではアイコンをタップすると表示され、もう一度タップすると非表示になります。
また、キーボードのTabキーでアイコンにフォーカスした場合も説明を表示できます。
パソコンでツールチップを表示する仕組み
パソコンでの表示切り替えには、CSSの:hoverを使用しています。
@media (hover: hover) and (pointer: fine)によって、マウスなどでホバーできる環境に限定して適用しています。
通常時はopacity: 0;とvisibility: hidden;で非表示にし、ホバーすると表示状態に切り替えます。
/* =========================================
PCでのマウスホバー表示
========================================= */
@media (hover: hover) and (pointer: fine) {
/* マウスカーソルを合わせたときに表示する */
.basic-tooltip_area:hover .basic-tooltip_message {
opacity: 1; /* 不透明にする */
visibility: visible; /* ツールチップを表示する */
}
}
:hoverは、マウスカーソルが対象領域に重なったときに適用されます。
カーソルを外すと通常時の非表示状態に戻ります。
また、.basic-tooltip_messageのtransitionによって、透明度が0.3秒で変化します。
表示速度を変更したい場合は、opacity 0.3s easeの数値を調整してください。
スマートフォンでタップして開閉する仕組み
スマートフォンではマウスホバーを使用できないため、script.jsでタップ操作による開閉を行っています。
matchMedia()でタッチ操作環境を判定し、「?」アイコンがクリックされたときにis-activeクラスを追加・削除します。
スマートフォンのタップでもclickイベントが発生するため、このイベントで開閉を制御できます。
/* ホバーできないタッチ操作環境を判定 */
const touchMode = window.matchMedia("(hover: none), (pointer: coarse)");
/* =========================================
ツールチップの表示状態を変更
========================================= */
function setTooltipOpen(open) {
/* 表示用クラスを追加・削除 */
area.classList.toggle("is-active", open);
/* 開閉状態をアクセシビリティ属性に反映 */
button.setAttribute("aria-expanded", String(open));
}
/* =========================================
アイコンのタップで表示・非表示
========================================= */
button.addEventListener("click", () => {
/* PCではクリックによる切り替えを行わない */
if (!touchMode.matches) return;
/* タップするたびに表示状態を反転 */
const isOpen = area.classList.contains("is-active");
setTooltipOpen(!isOpen);
});
touchMode.matchesがtrueの場合だけ、クリックによる開閉処理を実行します。
area.classList.contains("is-active")で現在の表示状態を確認し、setTooltipOpen(!isOpen)で状態を反転しています。
初回のタップではis-activeが追加され、再タップでは削除されます。
同時にaria-expandedもtrueまたはfalseへ更新しています。
タップ時とキーボード操作時の表示設定
JavaScriptでis-activeクラスが追加された場合と、キーボード操作によって「?」アイコンがフォーカスされた場合は、次のCSSでツールチップを表示しています。
/* =========================================
キーボード操作・スマホでの表示
========================================= */
/* キーボードフォーカス時とタップで開いたときに表示する */
.basic-tooltip_area:has(.basic-tooltip_button:focus-visible) .basic-tooltip_message,
.basic-tooltip_area.is-active .basic-tooltip_message {
opacity: 1; /* 不透明にする */
visibility: visible; /* ツールチップを表示する */
}
.basic-tooltip_area.is-activeは、スマートフォンでタップして開いた状態に適用されます。
:focus-visibleはキーボード操作などでフォーカス表示が必要な場合に適用され、:has()でそのボタンを含む領域のツールチップを表示しています。
タッチ操作環境からマウス操作環境へ切り替わった場合は、matchMedia()のchangeイベントで表示状態をリセットします。
/* =========================================
操作環境が切り替わった場合
========================================= */
touchMode.addEventListener("change", () => {
/* 以前の表示状態をリセット */
setTooltipOpen(false);
});
「?」アイコンの文字を変更する方法
アイコンに表示する文字は、index.htmlのbutton要素内に記述しています。
初期状態では「?」を表示しています。
<!-- PCではホバー、スマホではタップで操作するアイコン -->
<button class="basic-tooltip_button" type="button" aria-label="項目名の補足説明" aria-describedby="basic-tooltip-message" aria-expanded="false">
?
</button>
「?」を「!」や「i」などの文字に変更すると、同じ円形ボタンの中に別の文字を表示できます。
アイコンの大きさは.basic-tooltip_buttonのwidth: 34px;とheight: 34px;で指定しています。
文字サイズはfont-size: 20px;、文字色はcolor: #64748b;で調整できます。
aria-labelはアイコンの説明を示す属性です。
表示する項目の内容を変更した場合は、必要に応じてこの文字列も変更してください。
SVGアイコンに変更する方法
「?」の代わりにSVGアイコンを使用する場合は、button要素内の「?」をSVGコードに置き換えます。
次の例では、円の中に「i」を表示する情報アイコンを使用しています。
<!-- SVGアイコンを使用したボタン -->
<button class="basic-tooltip_button" type="button" aria-label="項目名の補足説明" aria-describedby="basic-tooltip-message" aria-expanded="false">
<svg viewBox="0 0 24 24" width="20" height="20" aria-hidden="true" focusable="false">
<circle cx="12" cy="12" r="10" fill="none" stroke="currentColor" stroke-width="2"></circle>
<path d="M12 11v6 M12 7h.01" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round"></path>
</svg>
</button>
SVGのwidth="20"とheight="20"を変更すると、アイコン自体の表示サイズを調整できます。
stroke="currentColor"を使用しているため、SVGの線の色には.basic-tooltip_buttonのcolorが適用されます。
SVGコードに個別の色を指定した場合は、その設定が優先されます。
ツールチップの説明文を変更する方法
表示する文章は、index.htmlの.basic-tooltip_messageに記述しています。
<!-- アイコンの上側に表示する補足説明 -->
<div class="basic-tooltip_message" id="basic-tooltip-message" role="tooltip">
ここに項目についての補足説明を表示します。
</div>
「ここに項目についての補足説明を表示します。」の部分を任意の文章に書き換えてください。
ツールチップの最大横幅はmax-width: 260px;で指定しています。
数値を大きくすると長い文章を横に広く表示でき、小さくすると折り返しが増えます。
文字サイズはfont-size: 14px;、背景色はbackground: #111827;、文字色はcolor: #ffffff;で変更できます。
aria-describedby="basic-tooltip-message"は説明文のIDを参照しています。
説明文のIDを変更する場合は、両方を同じ文字列にしてください。
ツールチップを上・下・左・右に表示する方法
ツールチップの表示方向は、style.cssの.basic-tooltip_messageと.basic-tooltip_message::afterで変更できます。
.basic-tooltip_messageは説明全体の配置を担当し、::afterは三角形の矢印を担当しています。
表示方向を変更する場合は、説明本体と矢印の両方を変更してください。
① 上側に表示する(初期設定)
アイコンの上側にツールチップを配置します。
今回の掲載コードで使用している設定です。
/* ツールチップを上側に配置 */
.basic-tooltip_message {
top: auto;
right: auto;
bottom: calc(100% + 12px);
left: 50%;
transform: translateX(-50%);
}
/* 下向きの矢印 */
.basic-tooltip_message::after {
top: 100%;
right: auto;
bottom: auto;
left: 50%;
transform: translateX(-50%);
border: 6px solid transparent;
border-top-color: #111827;
}
bottom: calc(100% + 12px);によって、アイコンの上端から12px離して配置しています。
left: 50%;とtranslateX(-50%)を組み合わせることで、アイコンの中央に揃えています。
② 下側に表示する
アイコンの下側にツールチップを配置する場合は、.basic-tooltip_messageと::afterの配置設定を次のように変更します。
/* ツールチップを下側に配置 */
.basic-tooltip_message {
top: calc(100% + 12px);
right: auto;
bottom: auto;
left: 50%;
transform: translateX(-50%);
}
/* 上向きの矢印 */
.basic-tooltip_message::after {
top: auto;
right: auto;
bottom: 100%;
left: 50%;
transform: translateX(-50%);
border: 6px solid transparent;
border-bottom-color: #111827;
}
top: calc(100% + 12px);でアイコンの下側に配置します。
矢印はツールチップの上端に移動し、border-bottom-colorで上向きに変更しています。
③ 左側に表示する
アイコンの左側に配置する場合は、横方向の位置をrightで指定し、縦方向を中央に揃えます。
/* ツールチップを左側に配置 */
.basic-tooltip_message {
top: 50%;
right: calc(100% + 12px);
bottom: auto;
left: auto;
transform: translateY(-50%);
}
/* 右向きの矢印 */
.basic-tooltip_message::after {
top: 50%;
right: auto;
bottom: auto;
left: 100%;
transform: translateY(-50%);
border: 6px solid transparent;
border-left-color: #111827;
}
right: calc(100% + 12px);によって、アイコンの左側に12pxの間隔を設けます。
top: 50%;とtranslateY(-50%)で縦方向の中央に揃え、矢印は右向きにしています。
④ 右側に表示する
アイコンの右側に配置する場合は、leftを使用して横方向の位置を指定します。
/* ツールチップを右側に配置 */
.basic-tooltip_message {
top: 50%;
right: auto;
bottom: auto;
left: calc(100% + 12px);
transform: translateY(-50%);
}
/* 左向きの矢印 */
.basic-tooltip_message::after {
top: 50%;
right: 100%;
bottom: auto;
left: auto;
transform: translateY(-50%);
border: 6px solid transparent;
border-right-color: #111827;
}
left: calc(100% + 12px);でアイコンの右側に配置し、border-right-colorで左向きの矢印を作成しています。
いずれの方向でも12pxを変更すると、アイコンとツールチップの間隔を調整できます。
また、矢印のborder: 6px solid transparent;の数値を変更すると、三角形の大きさを調整できます。
上記のコードは表示位置と矢印の変更部分です。
背景色・文字サイズ・余白・表示アニメーションなど、.basic-tooltip_messageに設定されているその他のCSSはそのまま残してください。
レスポンシブ対応
ツールチップ全体にはwidth: 100%;とmax-width: 680px;を設定しているため、設置先の横幅に合わせて縮小します。
また、画面幅640px以下では、外枠の内側余白とツールチップの横幅を変更しています。
/* =========================================
スマートフォンの画面幅調整
========================================= */
@media (max-width: 640px) {
/* 画面幅640px以下では全体の余白を小さくする */
.basic-tooltip_wrap {
padding: 24px 18px; /* 上下24px・左右18pxの内側余白 */
}
/* スマートフォンで説明文の横幅を調整する */
.basic-tooltip_message {
width: 220px; /* ツールチップの横幅 */
max-width: 70vw; /* 画面幅の70%を上限にする */
}
}
max-width: 70vw;は、ツールチップの最大横幅を画面幅の70%に制限する設定です。
画面幅に対して大きく表示したい場合は、この数値を調整してください。
ただし、左側・右側へ表示方向を変更した場合は、画面端からツールチップがはみ出すことがあります。
特にスマートフォンでは、設置位置や説明文の長さに合わせて横幅・表示方向を調整してください。
コメント