11tyで生成したマークダウン記事の画像を拡大する

| 4 min read
Author: noboru-kudo noboru-kudoの画像

早いものでデベロッパーサイトを開設して半年ほど経過しました。継続的に記事も公開し、もうすぐ100本に到達します。
今後は記事の執筆と並行して、サイト自体のUI/UX改善にも取り組んでいきたいと思います。

今回は改善要望として上がっていた記事の画像のズーム機能について対応しました。デベロッパーサイトなのでここではそのやり方も記事として紹介したいと思います。
現在このデベロッパーサイトでは、SSGツールのeleventyで、マークダウン記事をHTMLへと変換しています。
この中で表示サイズが大きい画像を使うと、解像度の低い端末やモニターではかなり見にくいです。
当初は画像をクリックすると別タブでオリジナル画像を表示をすることを考えましたが、やはり同一タブ内で見れる方がUX的に望ましいと思います。
これを実現するためのライブラリを探し、以下にたどり着きました。

ドキュメントを眺めてみると機能的に十分で、依存ライブラリもなく軽量です(GitHubスター数も20000を超えていてます)。
このPhotoSwipeを導入することにしました。

PhotoSwipeのインストール

#

まずはPhotoSwipeをインストールします。

npm install -D photoswipe

そのままではサイトからPhotoSwipeが見つかりません。11tyのビルド時に、PhotoSwipeをHTMLと一緒に静的リソース内として入れる必要があります。

11tyのエントリーポイントの.eleventy.jsで、このライブラリをコピーするようにします。

eleventyConfig.addPassthroughCopy({ "./node_modules/photoswipe/dist": "photoswipe" });

addPassthroughCopyは、変換処理はせずにそのままphotoswipeというディレクトリにコピーする11tyのメソッドです。

マークダウンパーサーのカスタマイズ

#

PhotoSwipeを導入する場合は、特定のHTMLタグや属性を設定する必要があります。

imgをaタグでラップし、そのaタグに専用のカスタム属性(data-pswp-width/data-pswp-height)を追加して、PhotoSwipeが扱うイメージのサイズ指定が必要です。
サイズはイメージによって異なりますし、執筆者に個別に指定させることは避けたいです。
このため、ここではimgタグのaタグラップのみにして、カスタム属性はページロード時に動的に設定することにします。

11tyではマークダウンパーサーにmarkdown-itを使います。こちらのデフォルトルール(imgタグのみ)を変更します。
再び.eleventy.jsを修正します。以下関連部分を抜粋します。

const markdownLibrary = markdownIt({
html: true,
breaks: true,
}).use((md) => {
const originalRule = md.renderer.rules.image;
md.renderer.rules.image = function (tokens, idx, options, env, self) {
const imageTag = originalRule(tokens, idx, options, env, self);
const token = tokens[idx];
return `<a id="image-swipe-${idx}" class="image-swipe" href="${token.attrs[token.attrIndex("src")][1]}" target="_blank" rel="noopener noreferrer">${imageTag}</a>`;
}
});

eleventyConfig.setLibrary("md", markdownLibrary);

ここではmarkdown-itのレンダラーのmd.renderer.rules.imageルールを上書きし、元々のimgタグをaタグでラップするようにしました。
また、後続のPhotoSwipeの初期化で、この要素をルックアップする必要があるため、idやclass属性を指定しました。

markdown-itのカスタムルールの書き方は、以下のドキュメントやソースコードを参考にしました。

PhotoSwipe初期化

#

これでPhotoSwipeを使う準備ができました。ページロード時にPhotoSwipeを初期化します。
11tyの記事で使っているベーステンプレートに以下を追加します。

  <script type="module">
import PhotoSwipeLightbox from '/photoswipe/photoswipe-lightbox.esm.js';
window.addEventListener('load', function() {
const anchors = document.querySelectorAll('a.image-swipe');
anchors.forEach((el) => {
const img = el.querySelector('img');
el.setAttribute('data-pswp-width', img.naturalWidth);
el.setAttribute('data-pswp-height', img.naturalHeight);
new PhotoSwipeLightbox({
gallery: `#${el.id}`,
pswpModule: () => import('/photoswipe/photoswipe.esm.js'),
}).init();
})
});
</script>

先程markdown-itのカスタムルールで追加したaタグを全て取得し、それぞれの要素でPhotoSwipeを初期化しています。
この中でPhotoSwipe向けのカスタム属性(data-pswp-width/data-pswp-height)を追加し、実際のイメージサイズに応じてPhotoSwipeが表示するサイズを動的に設定しています。

初期化の実装には、以下PhotoSwipeのドキュメントを参考にしました[1]

最後に、PhotoSwipeの動作にはCSSも必要です。こちらはPhotoSwipeのモジュール内に同梱されていますので、テンプレートのheadタグ内にいれておきます。

<link rel="stylesheet" href="/photoswipe/photoswipe.css">

動作確認

#

最後に実際に動かして確認します。
サイズの大きい画像のあるサンプル記事を作成して見てました。以下画像クリック時の動画です。

画像をクリックするとPhotoSwipeがズームやスワイプをやってくれているのが分かります。これを自前で実装するのはかなり大変ですね。PhotoSwipeありがとうございます。

上記で使用した画像はこちらです。同じように動作するはずです。

sample image

今後も継続的にUI/UXを改善し、参考になりそうなものは記事として投稿したいと思います。


  1. 将来的には、このJavaScriptのソースコードはミニファイしようと思います。 ↩︎

豆蔵デベロッパーサイト - 先週のアクセスランキング
  1. 基本から理解するJWTとJWT認証の仕組み (2022-12-08)
  2. AWS認定資格を12個すべて取得したので勉強したことなどをまとめます (2022-12-12)
  3. Nuxt3入門(第4回) - Nuxtのルーティングを理解する (2022-10-09)
  4. Viteベースの高速テスティングフレームワークVitestを使ってみる (2022-12-28)
  5. Nuxt3入門(第8回) - Nuxt3のuseStateでコンポーネント間で状態を共有する (2022-10-28)
  6. ORマッパーのTypeORMをTypeScriptで使う (2022-07-27)
  7. Nuxt3入門(第1回) - Nuxtがサポートするレンダリングモードを理解する (2022-09-25)
  8. Jest再入門 - 関数・モジュールモック編 (2022-07-03)
  9. GitHub Actions - 構成変数(環境変数)が外部設定できるようになったので用途を整理する (2023-01-16)
  10. Nuxt3入門(第7回) - Nuxt3のプラグイン・ミドルウェアを使う (2022-10-23)