ページを表示してから指定した時間が経過すると、ツールチップを自動で表示する方法を紹介します。今回は、ページ表示から3秒後に「項目名」の横にある「?」アイコンの上側へ補足説明が表示される仕組みを作成します。
通常のマウスホバーで表示するツールチップとは異なり、カーソルを合わせたり、ボタンをクリックしたりする必要はありません。ページが表示された時点から時間の計測が始まり、3秒後にツールチップがフェード表示されます。表示後は自動で閉じず、そのまま表示状態を維持します。
表示までの待機時間は変更できるため、1秒後や5秒後など、任意のタイミングで表示させることもできます。下のデモでは「もう一度確認する」ボタンを使って、時間経過による表示動作を繰り返し確認できます。
デモ
ページ表示から3秒後に、「項目名」の横にある「?」アイコンの上側へツールチップが自動表示されます。マウス操作は必要ありません。表示後はそのまま表示状態が維持されます。
「もう一度確認する」をクリックするとツールチップが非表示になり、3秒後に再び表示されます。
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">
<!-- ツールチップのJavaScriptを読み込む -->
<script src="script.js" defer></script>
</head>
<body>
<!-- ツールチップ全体 -->
<div class="tooltip-page-delay_wrap">
<!-- 項目名とツールチップ -->
<div class="tooltip-page-delay_item">
<span class="tooltip-page-delay_label">
項目名
</span>
<div class="tooltip-page-delay_area">
<!-- ツールチップの表示位置となる「?」ボタン -->
<button class="tooltip-page-delay_button" type="button" aria-label="項目名の補足説明" aria-describedby="tooltip-page-delay-message" aria-expanded="false">
?
</button>
<!-- 指定時間後に自動表示する補足説明 -->
<div class="tooltip-page-delay_message" id="tooltip-page-delay-message" role="tooltip">
ページ表示から3秒後に自動で表示されました。
</div>
</div>
</div>
</div>
</body>
</html>
コードをコピーする場合 使用するコードのタブを選び、「このタブをコピー」をクリックすると、現在表示中のコードをコピーできます。 サンプル一式を取得する場合 HTML・CSSなどすべてのファイルが必要な場合は、「サンプル一式をダウンロード」をクリックしてください。
Q ダウンロードしたけど、これをネット上で動かすにはどうするの?
Googleアカウントがあれば、InfinityFreeで無料サーバーを作成して、ダウンロードしたサンプルをネット上で動かせます。
InfinityFreeを初めて利用する場合は①から、すでにサーバーを作成している場合は②へ進んでください。
ファイル構成と設置方法
このサンプルは、ページ表示後に一定時間が経過するとツールチップを自動表示する仕組みです。 HTMLで「?」アイコンと補足説明を配置し、CSSで表示位置やデザインを設定しています。 JavaScriptでは、ページ表示時にタイマーを開始し、指定時間が経過したらツールチップを表示します。 マウスホバーやクリックによる操作は必要ありません。
sample/
├── index.html
├── style.css
└── script.js
各ファイルの役割
index.htmlには、「項目名」、円形の「?」ボタン、ツールチップに表示する補足説明を配置しています。
style.cssでは、ボタンのサイズや色、吹き出しの配置、三角形の矢印、フェード表示を設定しています。
script.jsでは、ページ表示時にタイマーを開始し、指定した時間が経過したときにツールチップを表示する処理を設定しています。
設置方法・使い方
「サンプル一式をダウンロード」をクリックしてZIPファイルを保存し、展開してください。
sampleフォルダ内のindex.html・style.css・script.jsを同じ階層に配置します。
index.htmlをブラウザで開くと、JavaScriptの実行開始から3秒後にツールチップが自動表示されます。
表示後は非表示にする処理がないため、そのまま表示状態が維持されます。
もう一度動作を確認する場合は、ページを再読み込みしてください。
表示までの時間を設定する仕組み
script.jsでは、delayTimeにツールチップを表示するまでの待機時間を設定しています。
setTimeout()は、指定時間が経過したあとに処理を実行するJavaScriptの機能です。
/* =========================================
表示までの待機時間
========================================= */
/* 3000ミリ秒(3秒)後に表示 */
/* 1000にすると1秒後、5000にすると5秒後に表示 */
const delayTime = 3000;
/* 表示タイマーを管理 */
let showTimer = null;
3000は3000ミリ秒、つまり3秒を表しています。
1秒後に表示したい場合は1000、5秒後に表示したい場合は5000に変更してください。
数値を大きくすると表示までの待機時間が長くなり、小さくすると短くなります。
変更する場所はscript.jsのdelayTimeです。
ページ表示時にタイマーを開始する処理
startTooltipTimer()は、ツールチップを初期状態に戻してから、指定時間後に表示するための関数です。
最初にclearTimeout(showTimer)で既存のタイマーを解除し、
setTooltipOpen(false)でツールチップを非表示にします。
その後、setTimeout()によって待機時間を設定し、時間が経過するとsetTooltipOpen(true)を実行します。
/* =========================================
指定時間後に表示する処理
========================================= */
function startTooltipTimer() {
/* 実行中のタイマーを解除 */
clearTimeout(showTimer);
/* ツールチップを初期状態に戻す */
setTooltipOpen(false);
/* 指定時間後にツールチップを表示 */
showTimer = setTimeout(() => {
setTooltipOpen(true);
showTimer = null;
}, delayTime);
}
/* =========================================
ページ表示時にタイマー開始
========================================= */
startTooltipTimer();
startTooltipTimer();は、JavaScriptの読み込み後に実行されます。
これにより、ボタンを操作しなくても自動的にタイマーが開始されます。
今回のコードには表示後にタイマーで閉じる処理を設けていないため、指定時間が経過して一度表示されると、そのまま表示状態が続きます。
ツールチップの表示状態を変更する仕組み
表示・非表示の切り替えにはsetTooltipOpen()を使用しています。
この関数では、ツールチップ本体にis-visibleクラスを追加・削除し、ボタンのaria-expanded属性も更新しています。
/* =========================================
ツールチップの表示状態を変更
========================================= */
function setTooltipOpen(open) {
/* 表示用クラスを追加・削除 */
message.classList.toggle("is-visible", open);
/* 開閉状態をアクセシビリティ属性に反映 */
button.setAttribute("aria-expanded", String(open));
}
openがtrueになるとis-visibleクラスが追加され、CSSの設定によってツールチップが表示されます。
style.cssでは、初期状態をopacity: 0;とvisibility: hidden;で非表示にし、
is-visibleクラスが付いたときに表示する仕組みです。
/* =========================================
指定時間経過後の表示状態
========================================= */
.tooltip-page-delay_message.is-visible {
opacity: 1; /* 不透明にする */
visibility: visible; /* ツールチップを表示 */
}
表示時のフェード速度は、.tooltip-page-delay_messageの
transitionで設定しています。
現在はopacity 0.3s easeなので、0.3秒かけて透明な状態から表示状態へ変化します。
ゆっくり表示したい場合は0.5sなどに変更してください。
この設定はフェードの速度であり、delayTimeで指定した表示待機時間とは別の設定です。
補足説明と表示位置の変更方法
ツールチップに表示する文章は、index.htmlの
tooltip-page-delay_message内に記述しています。
「項目名」や「?」の文字も同じファイルで変更できます。
ツールチップの表示位置は、style.cssの
.tooltip-page-delay_messageで設定しています。
.tooltip-page-delay_message {
position: absolute; /* ボタンを基準に配置 */
left: 50%; /* 左右中央の基準位置 */
bottom: calc(100% + 12px); /* ボタンから上に12px離す */
z-index: 10; /* 前面に表示 */
width: max-content; /* 内容に合わせた横幅 */
max-width: 260px; /* 最大横幅 */
padding: 10px 16px; /* 内側余白 */
border-radius: 8px; /* 吹き出しの角丸 */
background: #111827; /* 吹き出しの背景色 */
color: #ffffff; /* 吹き出しの文字色 */
font-size: 14px; /* 文字サイズ */
line-height: 1.6; /* 行間 */
text-align: left; /* 文字を左揃え */
transform: translateX(-50%); /* 左右中央に配置 */
opacity: 0; /* 初期状態は透明 */
visibility: hidden; /* 初期状態は非表示 */
pointer-events: none; /* 吹き出し自体へのマウス操作を無効化 */
transition:
opacity 0.3s ease, /* 透明度を0.3秒で変化させる */
visibility 0.3s ease; /* 表示状態を0.3秒で切り替える */
}
bottom: calc(100% + 12px);は、「?」ボタンの上側に12pxの間隔を空けて表示する設定です。
12pxを大きくするとボタンから離れ、小さくすると近づきます。
max-width: 260px;を変更すると吹き出しの最大横幅を調整できます。
補足説明が長い場合は、必要に応じて値を大きくしてください。
スマートフォンの画面幅調整
style.cssでは、画面幅640px以下の場合に外枠の内側余白とツールチップの横幅を変更しています。
ツールチップの横幅は220pxを基本とし、画面幅の70%を上限にすることで、狭い画面でも吹き出しが大きくなりすぎないようにしています。
/* =========================================
スマートフォンの画面幅調整
========================================= */
@media (max-width: 640px) {
.tooltip-page-delay_wrap {
padding: 24px 18px; /* 内側余白 */
}
.tooltip-page-delay_message {
width: 220px; /* 吹き出しの横幅 */
max-width: 70vw; /* 画面幅の70%を上限にする */
}
}
640pxは画面幅によってスタイルを切り替える基準です。
padding: 24px 18px;は上下24px・左右18pxの内側余白を設定しています。
なお、ツールチップの自動表示は画面幅に関係なく実行されます。
スマートフォンでもマウスホバーやタップ操作を必要とせず、指定時間が経過すると表示されます。
コメント