ページ表示後に指定時間でツールチップを表示する方法

ツールチップ
無料ツール
ツールチップを自由に作成

文章・色・サイズ・余白・位置・矢印・ボタンなどを設定して、HTML・CSSを自動生成できます。

ツールチップ作成ツールを使う
新しいタブで開きます

ページを表示してから指定した時間が経過すると、ツールチップを自動で表示する方法を紹介します。今回は、ページ表示から3秒後に「項目名」の横にある「?」アイコンの上側へ補足説明が表示される仕組みを作成します。

通常のマウスホバーで表示するツールチップとは異なり、カーソルを合わせたり、ボタンをクリックしたりする必要はありません。ページが表示された時点から時間の計測が始まり、3秒後にツールチップがフェード表示されます。表示後は自動で閉じず、そのまま表示状態を維持します。

表示までの待機時間は変更できるため、1秒後や5秒後など、任意のタイミングで表示させることもできます。下のデモでは「もう一度確認する」ボタンを使って、時間経過による表示動作を繰り返し確認できます。

デモ

項目名

ページ表示から3秒後に、「項目名」の横にある「?」アイコンの上側へツールチップが自動表示されます。マウス操作は必要ありません。表示後はそのまま表示状態が維持されます。

「もう一度確認する」をクリックするとツールチップが非表示になり、3秒後に再び表示されます。

Q 他のアイコンを使いたい場合はどうするの?
A

無料の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 ダウンロードしたけど、これをネット上で動かすにはどうするの?
A

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の内側余白を設定しています。
なお、ツールチップの自動表示は画面幅に関係なく実行されます。 スマートフォンでもマウスホバーやタップ操作を必要とせず、指定時間が経過すると表示されます。


こちらもおすすめ


コメント