Bloggerブログに目次の自動生成のJavaScriptプログラムを実装する

一般サイト向けの目次の自動生成のJavaScriptプログラムを公開してBloggerブログでも使えるので、どうすれば実装できるかを説明する。

どのような目次なのかやデザインや機能のカスタマイズについては一般サイト向けの記事を参考にして欲しい。僕が提供するBlogger用のImaginaryテーマはサンプルブログの自動生成の目次のカスタマイズの記事に専用のソースコードと実装方法を紹介している。目次の自動生成のプログラムのソースコードブログのテンプレートか投稿にscriptで、プログラムのソースコードを記載して使う。/* Copyright: Nagahito Yuki 2023 | https://www.nagahitoyuki.com/2023/03/implement-a-javascript-program-that-automatically-generates-a-table-of-contents-on-a-blogger-blog.html | License: The MIT License */ const pb = document.querySelector("div.post-body"), hdgs = pb.querySelectorAll("h1, h2, h3, h4"); if (hdgs[0]) { const toc = document.createElement("nav"), dts = document.createElement("details"), smr = document.createElement("summary"), fid = document.createElement("ol"); toc.id = "toc"; dts.open = true; smr.insertAdjacentHTML("afterbegin", "目次"); fid.className = "mdr"; dts.appendChild(smr); dts.appendChild(fid); toc.appendChild(dts); let n; hdgs.forEach((hdg, i) => { const tci = document.createElement("li"), tcl = document.createElement("a"), tn = Number(hdg.tagName.substring(1)); hdg.id = `content_${i + 1}`; tcl.href = `#${hdg.id}`; tcl.textContent = hdg.textContent; tci.appendChild(tcl); if (i !== 0 && tn > 1) { const lid = [...fid.querySelectorAll("li")].pop(), dr = tn - n; if (dr > 0) { const idx = document.createElement("ol"); idx.appendChild(tci); lid.appendChild(idx); } else if (dr === 0) { lid.after(tci); } else { let pol = lid; for (c = 0; c + dr < 0; c++) { if (!pol.closest("ol").classList.contains("mdr")) pol = pol.closest("ol").parentElement; else c = -dr; } pol.after(tci); }} else { fid.appendChild(tci); } n = tn; }); hdgs[0].before(toc); }先頭のコメント（/*〜*/）が著作権を示しているので、無料で使用するかぎり、必ず残して置かなくてはならないし、ソースコードを編集するときなども誤って消さないようにして欲しい。僕が提供する他の著作権付きプログラムやBlogger用のImaginaryテーマを使っている人はもう既にサイトのソースコードに著者名が記載されているからさらに追加する必要はなくて消しても構わない。今回の目次の自動生成のプログラムは記事／追加ページの本文の四種類の見出しを取り込んで目次の項目に階層化して最初の見出しの直前に表示する。Bloggerの投稿の見出しとタグの対応 Bloggerの投稿画像の作成ビューで見出しのメニューが開かれている

投稿｜Blogger

投稿の作成ビューには四つの見出しが用意されている。

主見出し

見出し

小見出し

準見出し

今回のプログラムの初期設定では記事／追加ページの本文で、どれかの見出しが使われたときに取り込んで目次の項目として見出しへのジャンプリンク付きで表示する。見出しのidの上書きと一般サイト向けとの違い目次の項目から見出しへのジャンプリンクを作成するために対象の見出しタグ、初期状態ではh1とh2とh3とh4には固有のidが付けられることになる。注意：目次の項目のジャンプリンクを作成するために見出しのidを見出しの順番で新しく付けていて既存のものがあっても上書きしてしまう。見出しの既存のidを保持して目次のジャンプリンクにも使うには上記のソースコードのhdg.id = `content_${i + 1}`;をif (!hdg.id) hdg.id = `content_${i + 1}`;に書き換えて使う。その他のカスタマイズは一般サイト向けの記事に載せている。Bloggerでソースコードを扱う場合、テンプレートの編集だとXMLだから使うとエラーになる記号があるから注意しなくては行けない。上記のソースコードはJavaScriptの「<」と「>」の一部と全ての「&」を文字実体参照の「<」と「>」と「&」に書き換えているので、一般サイト向けのソースコードとは少しだけ違う。目次の自動生成のプログラムの実装方法目次の自動生成のプログラムはscriptタグで囲ってブログのHTMLに記載する。<script> 目次の自動生成のプログラムのソースコード </script>記事／追加ページの本文のHTMLの親ボックスがプログラムの冒頭の("div.post-body")で、つまりpost-bodyのclassを持つdivタグと指定されていてこれが合わないと動作しない。公式テーマは全て大丈夫で、多くの非公式テーマも同じだろうけど、もしも異なっていたらプログラムの「div.post-body」を相応しいものに書き換える必要がある。書き換える際は「タグ名#id」「タグ名.class」などのCSSのセレクターと同じ書式で行う。投稿に個別に使うときは投稿画面のHTMLビューで、目次に取り込みたい全ての見出しの後に目次のscriptを記載すれば動作する。注意：HTMLビューでは目次の自動生成のソースコードのXMLのための二つの「&」を「&」、一つの「<」を「<」、三つの「>」を「>」に書き換えて使用する。ブログのテンプレートのソースコードに目次のscriptを記載すれば一回で、全ての記事／追加ページに見出しがあるかぎり、目次が自動生成されて表示できるようになる。テンプレートにソースコードを記載する

テーマ｜Blogger

Bloggerの管理画面のテーマのメニュー（▼）の「HTMLを編集」か「バックアップ」と「元に戻す」からテンプレートxmlファイルに目次のscriptを記載する。テンプレートのソースコードに目次のscriptを記載するならば記事／追加ページにしか必要ないので、Bloggerの条件分岐の独自タグのifで他の種類のページで使わないように振り分けた方が無駄がない。<b:if cond='data:view.isSingleItem'> 目次のscript </b:if>加えて記事ページと追加ページのどちらかしか目次を使わないという設定も可能になる。cond属性の内容を変える。

記事ページの振り分け条件

data:view.isPost

追加ページの振り分け条件

data:view.isPage

元のソースコードの「data:view.isSingleItem」（記事／追加ページ）となっている振り分け条件を書き換えると記事ページか追加ページに目次の使用を限定できる。どこに記載するかは目次の表示速度を気にしなければテンプレートのソースコードの最後、bodyの閉じタグの</body>の直前が分かり易くて動作も確実だけど、今回のプログラムは最初の見出しの直前に目次を挿入するので、初回画面に入る位置で、もしも遅れると次のコンテンツを押し下げる違和感を与え兼ねないと懸念される。普通の仕方で、表示速度をなるべく上げるには目次に取り込む見出しのある本文の直ぐ後に目次の自動生成のソースコードを置いて開始できるようにするのが良いと思うので、紹介しておく。記事／追加ページの本文の直後に目次のscriptを記載する公式テーマだと「post-body entry-content」のclassが付いたdivが本文の親ボックスになっているので、その直後に目次のscriptを記載する。<div class='post-body entry-content'> （中略） </div> 目次のscriptdivには他の属性が付いていたり、中身も異なるので、テンプレートのソースコードによって変わるけれどもclass='post-body entry-content'に着目すれば間違いない。注意：Bloggerのレイアウトバージョン２のテンプレートは本文のソースコードがパソコンとスマホの二つに分かれている。テンプレートのソースコードの冒頭のhtmlタグにb:version='2'が付いているとレイアウトヴァージョン２となる。公式テーマだと七種類が含まれる。

Simple

Dynamic Views

Picture Window

Awesome Inc.

Watermark

Ethereal

Travel

七つのテーマはパソコン版／デスクトップ表示の本文に目次のscriptを追加してテンプレートを管理画面のテーマの「モバイルの設定」でスマホにも対応させる場合はスマホ版／モバイル表示の本文にもscriptを追加するようになる。レイアウトヴァージョン２のパソコン版の本文のソースコード<b:includable id='post' var='post'> （中略） <div class='post-body entry-content' expr:id='"post-body-" + data:post.id' expr:itemprop='(data:blog.metaDescription ? "" : "description ") + "articleBody"'> <data:post.body/> <div style='clear: both;'/>  </div> 目次のscript （中略） </b:includable>Bloggerの非公式テーマもレイアウトヴァージョン２だと本文のソースコードかパソコンとスマホの二つの分かれているかも知れない。目次のscriptを本文の直後に置いても本文に遅れて目次か挿入される時間差を全て取り除くことはできないので、どうしても気がかりな場合は一般向けの記事に載せた完全な回避策を取ると良いと思う。投稿画像のカスタマイズに組み込む僕が提起した投稿画像の遅延読み込みのloading-lazyとIntersection Observer API、または軽量化のWebPのカスタマイズを実装してちるテンプレートはそこに目次の自動生成のプログラムを組み込むと目次を画像以外のコンテンツとして他のものと一緒に表示できるから通常の本文との表示の時間差を解消できる。注意：投稿画像のソースコードが画像なしのページでも記載されて部分的に使用されるので、全てのページで本文自体の表示速度が僅かに――プログラムの処理の分だけ――下がることになる。目次の自動生成のプログラムの投稿画像のプログラムへの組み込みは三つの手順で行われる。

画像用の二つの振り分けタグを外す

ソースコードの最初の方を編集する

画像なしのページの処理を追加する

三番目の手順は投稿画像のソースコードが動画を除外するものになっていたらそこに必要な目次の処理も含まれるから行わなくて良い。画像用の二つの振り分けタグを外す目次は画像なしのページでもあり得るので、全てのページで投稿画像のプログラムを記載して画像なしのページでは部分的に使用する。ソースコードの三箇所を削除する。<b:tag class='blog-content' cond='data:view.featuredImage' name='noscript'><data:post.body/></b:tag><b:if cond='!data:view.featuredImage'> 投稿画像のソースコード </b:if>※打ち消し線が不要な部分。cond属性の内容は使い方によって違う場合もあるかも知れないけれどもどんな内容でもtagタグの方はcond属性だけ消してifタグの方はタグ自体を外す。ソースコードの最初の方を編集する投稿画像のソースコードの最初の方に目次のソースコードを追加する。元のソースコードconst blimgs = npsbd.querySelectorAll("img");新しいソースコードconst blimgs = npsbd.querySelectorAll("figure:not(.normal) img, iframe"), hdgs = npsbd.querySelectorAll("h1, h2, h3, h4"); if (hdgs[0]) { const toc = document.createElement("nav"), dts = document.createElement("details"), smr = document.createElement("summary"), fid = document.createElement("ol"); toc.id = "toc"; dts.open = true; smr.insertAdjacentHTML("afterbegin", "目次<span/>"); fid.className = "mdr"; dts.appendChild(smr); dts.appendChild(fid); toc.appendChild(dts); let n; hdgs.forEach((hdg, i) => { const tci = document.createElement("li"), tcl = document.createElement("a"), tn = Number(hdg.tagName.substring(1)); hdg.id = `content_${i + 1}`; tcl.href = `#${hdg.id}`; tcl.textContent = hdg.textContent; tci.appendChild(tcl); if (i !== 0 && tn > 1) { const fis = fid.querySelectorAll("li"), lid = fis[fis.length - 1], dr = tn - n; if (dr > 0) { const idx = document.createElement("ol"); idx.appendChild(tci); lid.appendChild(idx); } else if (dr === 0) { lid.after(tci); } else { let pol = lid; for (c = 0; c + dr < 0; c++) { if (!pol.closest("ol").classList.contains("mdr")) pol = pol.closest("ol").parentElement; else c = -dr; } pol.after(tci); }} else { fid.appendChild(tci); } n = tn; }); hdgs[0].before(toc); }投稿画像のソースコードの("img")の部分の内容は使い方によって異なる場合がある。そのままで構わなくて半角コンマ（,）で繋いで目次のソースコードの少し加工したものを追加する。目次のソースコードの直後には投稿画像のソースコードが来て使い方によって異なるけど、if (blimhs[0])かそれを外した次の行のPromise.allになると思う。ソースコードの最後の方を編集する投稿画像のソースコードの最後に目次のソースコードを少し追加する。最初の方に動画を除外する振り分けのif (blimgs[0])が付いていれば不要で、ない場合に新しく追加して記事／追加ページに画像がない場合でも見出しかあれば目次を表示できるようにする。if (blimgs[0]) { Promise.all([...blimgs].map(blimg => { （中略） // Intersection Observer APIのタイプ if ("IntersectionObserver" in window) postContentObserver.observe(result); else result.src = result.dataset.src; }); }); // lazy-loadingかrwのタイプ psbd.parentNode.replaceChild(npsbd, psbd); }); } else { psbd.parentNode.replaceChild(npsbd, psbd); }※太字が追加する部分。投稿画像のソースコードのタイプによって二つ目に追加する新しいソースコードの直前の状況が違うけど、とにかくPromise.allのところから最後までをif (blimgs[0]) {と

} else {
psbd.parentNode.replaceChild(npsbd, psbd); }

で囲むと画像なしのページの目次の処理が可能になる。目次のデザインのソースコードブログに実装した目次の自動生成のプログラムに合わせて投稿かテンプレートのCSSに記載する。#toc>details {background-color:rgba(176, 196, 222, 0.02);border:1px #b0c4de outset;padding:1em} #toc>details>summary {list-style-type:none;display:flex;justify-content:space-between} #toc>details>summary>span {text-decoration:dotted underline .125em} #toc>details>summary>span::before {content:'開く'} #toc>details[open]>summary>span::before {content:'閉じる'} .mdr {margin-bottom:0} .mdr ol {padding-left:1.25em} .mdr li {margin:4px auto}目次に枠線や開閉ボタンなどの初期のデザインを付けられる。どんな内容か、そしてカスタマイズに使えるCSSの指定先などについては一般サイト向けの記事に載せている。目次のデザインの追加BloggerでCSSを使うには主に三つの仕方が考えられる。

投稿の編集画面のHTMLビュー

テーマのカスタマイズのCSSを追加

テーマのxmlファイルの編集

それぞれの特徴と実装方法について取り上げる。投稿の編集画面のHTMLビュー目次を個々の投稿に追加するために投稿の編集画面に目次のscriptを記載した場合はデザインのCSSも目次のない他のページには必要ないからプログラムと一緒に記載すると良いと思う。JavaScriptで目次の自動生成のプログラムにデザインのCSSを組み込んで使うことができる。document.head.querySelector("style").insertAdjacentHTML("beforeend", "改行なしの目次のCSS");このソースコードを目次の自動生成のプログラムの冒頭のconst pbの直前などに記載すると目次のCSSも反映する。注意：プログラムに追加するCSSのソースコードは改行せず、全てが繋がって一行になるように加工しておかないとエラーで目次が表示されなくなる。CSSに変更を加えたいときもプログラムの中で、編集することができる。テーマのカスタマイズのCSSを追加 BloggerのテーマのカスタマイズのCSSを追加

カスタマイズ｜Blogger

目次をテンプレートに追加した場合はデザインのCSSも全ての記事／追加ページに追加する必要があってテーマのカスタマイズのCSSを追加が適している。Bloggerの管理画面のテーマのカスタマイズの詳細設定の「CSSを追加」を使うとテンプレートに新しいCSSのソースコードを記載できる。入力欄に目次のソースコードを入力して保存する。テーマのxmlファイルの編集目次をテンプレートに追加した場合はデザインのCSSも全ての記事／追加ページに追加する必要があってテーマのxmlファイルの編集が適している。Bloggerの管理画面のテーマのメニュー（▼）の「HTMLを編集」か「バックアップ」と「元に戻す」を使うとテンプレートに新しいCSSのソースコードを記載することができる。目次のscriptを記載する場合と同じだ。<b:skin><![CDATA[/* （中略）目次のCSS ]]></b:skin>Bloggerの公式テーマと多くの非公式テーマで、head内にskinタグがあってHTMLのstyleに変換される部分なので、目次のCSSを他の振り分けのCSSに紛れ込まないように閉じタグの末尾の]]></b:skin>の直前などに記載すると良いと思う。万一、skinがなければstyle、styleもなければ投稿の編集画面のHTMLビューと同じように目次のscriptに組み込んでも構わない。document.head.querySelector("style").insertAdjacentHTML("beforeend", "details:has(.mdr)>summary {list-style-type:none}details:has(.mdr) ol {padding-left:1.25em}.mdr {margin-bottom:0}#toc>details {background-color:rgba(176,196,222,0.02);border:1px #b0c4de outset;padding:1em}#toc>details>summary {display:flex;justify-content:space-between}#toc span {text-decoration:dotted underline .125em}#toc>details>summary>span::before {content:'開く'}#toc>details[open]>summary>span::before {content:'閉じる'}"); const pb = document.querySelector("div.post-body"), hdgs = pb.querySelectorAll("h1, h2, h3, h4"); if (hdgs[0]) { const toc = document.createElement("nav"), dts = document.createElement("details"), smr = document.createElement("summary"), fid = document.createElement("ol"); toc.id = "toc"; dts.open = true; smr.insertAdjacentHTML("afterbegin", "目次<span/>"); fid.className = "mdr"; dts.appendChild(smr); dts.appendChild(fid); toc.appendChild(dts); let n; hdgs.forEach((hdg, i) => { const tci = document.createElement("li"), tcl = document.createElement("a"), tn = Number(hdg.tagName.substring(1)); if (!hdg.id) hdg.id = `content_${i + 1}`; tcl.href = `#${hdg.id}`; tcl.textContent = hdg.textContent; tci.appendChild(tcl); if (i !== 0 && tn > 1) { const lid = [...fid.querySelectorAll("li")].pop(), dr = tn - n; if (dr > 0) { const idx = document.createElement("ol"); idx.appendChild(tci); lid.appendChild(idx); } else if (dr === 0) { lid.after(tci); } else { let pol = lid; for (c = 0; c + dr < 0; c++) { if (!pol.closest("ol").classList.contains("mdr")) pol = pol.closest("ol").parentElement; else c = -dr; } pol.after(tci); }} else { fid.appendChild(tci); } n = tn; }); toc.insertAdjacentHTML("beforeend", "<p>※この目次は今回のプログラムによる自動生成と表示の実装サンプルになっている。</p>"); hdgs[0].before(toc); }