このサイトについて >>

[SWELLカスタマイズ] サイドバー目次のハイライト表示方法

本サイトのリンクには広告が含まれます。
SWELL目次カスタマイズ

当サイト「あふぃぶ」では、ワードプレスの設定、運用方法など、テクニカルな情報を中心にお伝えしています。

WordPresテーマ SWELLの目次のカスタマイズ方法をおしえて!

SWELLの目次をどのようにカスタマイズしたいですか?

本サイトのおすすめカスタマイズは、目次の表示位置のハイライト表示です。

この記事では、ワードプレステーマ「SWELL」の目次のカスタマイズ方法について解説します。

ぺん

本サイトで実施している、SWELL目次のカスタマイズ内容についてご紹介します。

この記事の内容
  1. SWELLのサイドバーへの目次ウイジェット設置方法
  2. SWELLの目次ハイライト表示方法
  3. オリジナルプラグイン「toc_highlight」の紹介

ブログ用テーマには
SWELLが特におすすめです

更新履歴 for SWELL

2022/02/13 JavaScript リファクタリング

2022/06/04 Swellのバージョンアップに伴い、ハイライト色の指定方法が変更になりました。(更新箇所へ

目次

SWELLの「目次をハイライトする表示」方法

SWELL目次カスタマイズ ウイジェットエリアに目次を表示する
ウイジェットの目次の設置例

ウイジェットエリアに記事の目次を表示しているサイトをよく見かけますよね?

本サイトでも、 スクロールに追従する目次ウイジェットを表示しているのですが、

ウイジェットに目次を表示すると、

  • 記事構成がわかりやすい
  • 読みたい個所にワンクリックで遷移できる
  • 長文記事が閲覧しやすくなる

というメリットがあります

ぺん

スクロールに追従する ウイジェットは、PCとタブレットに対応しています。

【SWELL】 サイドバーへの目次ウイジェットの設置方法

PC

ワードプレステーマ「SWELL」の目次をサイドバーに設置する方法を解説します。

STEP
ウイジェット設定画面を開く

ワードプレス管理画面から、外観ー>ウイジェットを選択します。

SWELL目次をサイドバーに設置する方法1
STEP
追尾サイドバーを選択

追尾サイドバーはスクロールに合わせて固定表示させるサイドバーです。

SWELL目次をサイドバーに設置する方法2
STEP
[SWELL] 目次 を追加

追尾サイドバーに [SWELL] 目次ウイジェットをドラッグして「完了」リンクをクリックします。

SWELL目次をサイドバーに設置する方法3

これで、SWELLのサイドバーに目次が表示されるようになります。

記事の表示位置が「目次にハイライト表示」されるとユーザビリティーが向上する

ハイライトマーカー

目次のハイライト表示って何がメリットなのですか?

サイドバーに目次を表示すると、以下のメリットがあります。

  • 記事の構成が分かりやすくなる
  • 必要な章にすぐに移動できるので、長文記事が閲覧しやすくなる

さらに、「現在のスクロール位置」を表示することで、

  • 現在の表示位置が分かりやすくなる

という効果が追加されます。

つまりこのカスタマイズは、サイトにアクセスいただいたユーザーに対する、ユーザビリティ(使い勝手)の向上に効果があるということです。

ぺん

目次がハイライト表示されると、重要な個所をザッピング(飛ばし読み)するにも便利ですね。

SWELLの「目次ハイライト表示」カスタマイズ方法

ここからは、SWELLの「目次ハイライト表示」のカスタマイズ方法を解説します。

本とマーカー

SWELLの「目次ハイライト表示」の仕組み

目次のハイライト表示って、どんな仕組みで動作しているの?

目次をハイライト表示するためには、JavaScriptとCSS(スタイルシート)を利用します。

JavaScriptの処理概要について解説します。

すぐに設定方法を知りたいかたは、2-2 SWELLの「目次ハイライト表示」の設定方法をご覧ください。

document.documentElement.clientHeightプロパティでスクロール位置を取得する

clientHeight
clientHeightで、現在のスクロール位置の縦座標を取得します。

document.documentElement.clientHeightプロパティを参照すると、 現在のスクロール位置の縦座標の値を取得できます。

getElementById()で目次のリンク位置を取得する

getElementbyId
getElementById()は、Hタグの縦座標を取得します。

getElementById()メソッドを使うと、<h2><h3>などの見出し位置の縦座標の値を取得できます。

先ほど取得した document.documentElement.clientHeigh の値と比較することで、 現在のスクロール位置に最も近い見出しを判定します。

classList.addメソッドで、現在の表示位置をマーキングする

classList.add
classList.addメソッドで、現在の表示位置に該当する箇所にCSSクラスを追加します。

現在のスクロール位置に最も近い見出しに、classList.addメソッドを用いてHTMLを動的に書き換えます。

<div class="p-toc post_content">
    <ul class="p-toc__list is-style-index">
        <li><a href="#index_id0" class="p-toc__link" data-nodal="">CSS(スタイルシート)は画面デザインの定義</a>
            <ul>
                <li><a href="#index_id1" class="p-toc__link" data-nodal="">CSSのデザイン定義方法</a></li>
                <li><a href="#index_id2" class="p-toc__link current" data-nodal="">Cascading(カスケーディング)は「連鎖する」という意味</a></li>
                <li><a href="#index_id3" class="p-toc__link" data-nodal="">CSS定義の”連鎖”は上書き可能</a></li>
            </ul>
        </li>
        <li><a href="#howto" class="p-toc__link" data-nodal="">WordPressのCSS(スタイルシート)設定方法</a></li>
        <li><a href="#index_id5" class="p-toc__link" data-nodal="">さいごに</a>
            <ul>
                <li><a href="#index_id6" class="p-toc__link" data-nodal="">CSSデザインに費やす時間に注意しよう</a></li>
                <li><a href="#index_id7" class="p-toc__link" data-nodal="">本サイトのCSSデザインカスタマイズ</a></li>
            </ul>
        </li>
    </ul>
</div>
種別SWELL目次ウイジェットのHTMLタグ例
通常の見出し<a href=”#index_id1″ class=”p-toc__link” data-nodal=””>見出し</a>
現在表示中の見出し <a href=”#index_id1″ class=”p-toc__link current” data-nodal=””>見出し</a>
HTMLタグの書き換え例

current というクラスがついた箇所が、現在のスクロール位置ということになります。

CSS(スタイルシート)で、マーキング位置をハイライト表示する

あとは簡単。

current というクラスがついたAタグがハイライト表示するように、スタイルシートを定義すればOKです。

a.p-toc__link.current {
  background-color: #edf5ff !important;
}

SWELLの「目次ハイライト表示」の設定方法

目次の「ハイライト表示」設定方法を解説します。

  1. テーマのFunction.phpにJavaScriptを登録するコードを追加する 
  2. スタイルシートでハイライト表示のデザインを定義する

1. テーマのFunction.phpにJavaScriptを登録するコードを追加する  

下記のコードを、SWELLの子テーマのfunction.phpに追加してください。

このコードを追加すると、目次をハイライト表示するJavaScriptがHTMLにインラインで出力されます。

function.phpファイルはワードプレステーマの必須ファイルの一つです。このファイルなどにコードを記述することで、ワードプレステーマの機能をカスタマイズすることができます。

function swell_toc_highlight() {
  echo <<< EOM
  <script>
  class toc_highlight {
    init(){
      this.elem = document.querySelectorAll('.widget_swell_index a');
      this.elem2 = document.querySelectorAll('.-modal a');
    }
    update(){
      if(this.elem === null) {
        return 0;
      } else {
        for (let i = 0; i < this.elem.length; i++) {
          const y = document.documentElement.clientHeight;
          const a = document.getElementById( this.elem[i].hash.slice(1) ).getBoundingClientRect().top;
          if( y > a ){
            this.elem[i].classList.add("current");this.elem2[i].classList.add("current");
              if ( i>0 ){
                this.elem[0].classList.remove("current");this.elem2[0].classList.remove("current");
                this.elem[i-1].classList.remove("current");this.elem2[i-1].classList.remove("current");
              }
          } else {
            this.elem[i].classList.remove("current");this.elem2[i].classList.remove("current");
          }
        }
      }
    }
  }
  var toc=new toc_highlight();
  window.addEventListener('DOMContentLoaded', function(e){ toc.init(); });
  window.addEventListener('scroll', function(e){ toc.update(); });  
  </script>
  EOM;
  }
add_action( 'wp_print_footer_scripts', 'swell_toc_highlight' );
2022/2/4更新

PCやタブレット画面で「目次アイコン」をクリックした際に、表示箇所のヘッダーもハイライト表示するように、スクリプトを更新しました。

SWELL目次アイコン
SWELL目次アイコン


function.phpファイルの書き換えに必要な、FTPクライアントの設定方法については、下記の記事で解説しています。

>>SFTPクライアント(WinSCP、FileZilla)の詳細設定方法

2. スタイルシートでハイライト表示のデザインを定義する

下記のCSS(スタイルシート)を追加してください。

a.p-toc__link.current {
  background-color: #edf5ff !important;
}

#edf5ffの部分は、必要に応じて任意の値に書き換えてください。

スタイルシートの追加方法については、下記の記事で解説しています。

>>WordPressのCSS(スタイルシート)の設定方法

SWELLの子テーマのfunction.phpの書き換え例

カスタムコードを、SWELL子テーマのfunction.phpのどこの場所に書けばのか?というご質問をいただきましたので、実際のfunction.phpの記述例をご紹介します。

<?php

/* ※ 子テーマのfunctions.phpは、親テーマのfunctions.phpより先に読み込まれることに注意してください。 */


/**
 * 親テーマのfunctions.phpのあとで読み込みたいコードはこの中に。
 */
add_filter('after_setup_theme', function(){
    
}, 11);


/**
 * 子テーマでのファイルの読み込み関数
 *   $query : 各ファイルに付与するクエリ文字列。
 */
add_action('wp_enqueue_scripts', function() {
    
    //$query = '1.0';
    $query = date('Ymdgis');  /*子テーマのstyle.cssのブラウザキャッシュを無効にする。 */

    /* 子テーマのstyle.css読み込み */
    wp_enqueue_style( 'child_style', get_stylesheet_directory_uri() .'/style.css', [], $query );

    /* その他の読み込みファイルはこの下に記述 */

}, 11);

add_action( 'wp_head', 'afb_highlight_toc_css' );
function afb_highlight_toc_css(){
  echo '<style>a.p-toc__link.current {background-color: var(--color_capbox_02_bg);}}</style>';
}

function swell_toc_highlight() {
  echo <<< EOM
  <script>
  class toc_highlight {
    init(){
      this.elem = document.querySelectorAll('.widget_swell_index a');
      this.elem2 = document.querySelectorAll('.-modal a');
    }
    update(){
      if(this.elem === null) {
        return 0;
      } else {
        for (let i = 0; i < this.elem.length; i++) {
          const y = document.documentElement.clientHeight;
          const a = document.getElementById( this.elem[i].hash.slice(1) ).getBoundingClientRect().top;
          if( y > a ){
            this.elem[i].classList.add("current");this.elem2[i].classList.add("current");
              if ( i>0 ){
                this.elem[0].classList.remove("current");this.elem2[0].classList.remove("current");
                this.elem[i-1].classList.remove("current");this.elem2[i-1].classList.remove("current");
              }
          } else {
            this.elem[i].classList.remove("current");this.elem2[i].classList.remove("current");
          }
        }
      }
    }
  }
  var toc=new toc_highlight();
  window.addEventListener('DOMContentLoaded', function(e){ toc.init(); });
  window.addEventListener('scroll', function(e){ toc.update(); });  
  </script>
  EOM;
  }
add_action( 'wp_print_footer_scripts', 'swell_toc_highlight' );

カスタムコードは、SWELL子テーマのfunction.phpの29行目より下に記述頂けば動作します。

30~33行では、スタイル(CSS)をインラインで出力しています。必要に応じてカスタマイズしてください。

function.phpを書き換える際は、事前にfunction.phpファイルのバックアップをしておき、不具合が発生した場合はFTPクライアントで上書きをしてください。

目次のハイライト表示が行えるプラグインをつくりました

function.phpの書き換えが初めてなので、むずかしいです。

ぺん

function.phpの書き換えが不要になる、お手軽な方法をご用意しました。

この記事でご紹介した「目次ハイライトのカスタマイズ」を簡単に行うための専用プラグインをご用意しました。

このプラグイン「toc_highlight」をインストールするだけで、目次をハイライト表示することができます。

無料でご利用いただけるので、ぜひ お試しください。

さいごに

絵具とパレット

今回は、ワードプレステーマ「SWELL」の目次のカスタマイズ方法をご紹介しました。

このカスタマイズは、PCとタブレットユーザーにしか対応できませんが、ユーザビリティー向上に役立つ施策なのでおすすめです。

ぜひお試しください!

このサイトでも使用している、ワードプレステーマ「SWELL」の詳しいレビューは、下記からご覧いただけます。

>>WordPress有料テーマ「SWELL」はおすすめ?移行後8か月の辛口レビュー

ブログ用テーマには
SWELLが特におすすめです

ワードプレステーマ「JIN」Rich Table of Contents(RTOC)目次表示用プラグインのカスタマイズ方法については、以下の記事で解説しています。

SWELL目次カスタマイズ

この記事が気に入ったら
フォローしてね!

よかったらシェアをお願いします!

コメント

コメント一覧 (5件)

  • はじめまして。
    とても役に立つSWELLカスタム情報など、いつも参考にさせて頂いております。

    不躾な質問で誠に恐縮ですが、今回のサイドバー目次の「ハイライト表示」をご説明通りに実施しているのですが再現できず、確認ですがSWELLの子テーマのfunction.phpの追記の場所は一番最後、「 /* その他の読み込みファイルはこの下に記述 */ }, 11); 」の行の後に追記でよろしいでしょうか。

    いろいろと追記場所を試したのですが再現出来ず、何かSWELLの他の設定が起因してるかと悩んでおります。(因みにfunction.phpの追記は、WPの外観>テーマファイルエディターより直接、書き込んでおります)

  • Toyooさん、

    コメントをいただき、ありがとうございます。

    再度検証してみました。
    ご指摘のとおり、SWELL子テーマのfunction.phpの最後にカスタムコードを追記いただけば、動作することを確認いたしました。

    本記事に「SWELLの子テーマのfunction.phpの書き換え例」という章を追加しましたので、ご参考になさってください。

    ご不明点がございましたら、お気軽にお知らせください。

    <検証した環境>
    WordPress: 5.8.1
    SWELL: 2.5.8.4
    PHP: 7.4.25

  • ぺんさん

    色々とご丁寧なご対応、誠に感謝しております。気づいたらプラグインまでお作りいただきもう涙目です。

    function.phpの書き換え例も、素人にも非常に分かりやすく大変、助かりました!CSSで色もHEX記号で自由に書き換えが出来て本当に助かります!

    お忙しい最中、このような対応、本当に感謝致します。

    今後も本サイトを活用させて頂けたら幸いです。
    本当に有り難うございました。

    • Toyooさん、
      ご返信いただきありがとうございました。
      今後とも、どうぞよろしくお願いいたします。

  • はじめまして!
    swellでは目次のハイライト機能はできないものだとあきらめていましたが、こちらの記事で紹介いただいた内容でできました!
    しかも簡単に配色のカスタマイズもできて、、、
    本当にありがとうございます!!
    他の方のブログにコメントを残すのは初めてですが感動のあまりコメントさせていただきました。

Toyoo へ返信する コメントをキャンセル

CAPTCHA


目次