ホームページをリニューアルしました の技術的な部分をまとめます。
構成
静的サイトとして Astro で構築し、操作が必要な部分だけ SolidJS と Kobalte のアイランドとして読み込んでいます。スタイルは Tailwind CSS です。
JavaScript を無効にしても全ページが問題なく読めます。動くのはテーマ切替、言語切替、一覧の絞り込み、スタートメニューだけで、本文の表示には一切関わっていません。
UI
UI は KDE Plasma や LXQt のデスクトップ環境を下敷きにしています。画面下部に固定されたパネルはタスクバー、スマートフォンのハンバーガーメニューはスタートメニューのアプリ一覧として設計しました。
角丸もグラデーションもぼかしも使っていません。平常時はどの枠も 1px の無彩色の線で、色と太さが付くのは光っているときだけです。
操作時の演出
カーソルやタッチに反応して要素がわずかに動くのは、水面の波紋をモチーフにした演出です。波紋そのものは描画せず、「触れた点が少し沈み、周囲が押し出され、すぐ元に戻る」という動きだけを表現しました。読みにくくならないよう、振幅は数ピクセル、復帰は 130ms に抑えてあります。
prefers-reduced-motion が指定されている環境では、要素は動きません。移動も傾きも持ち上がりも止まり、枠の発光だけが残ります。光ることは動くことではないので、止める理由がないためです。設定を切り替えた時点で、既に傾いている要素も含めて即座に反映されます。
日本語の組版
日本語の本文は BudouX で文節を判定し、改行してよい位置にだけ <wbr> を入れています。単語の途中で行が折れることがないので、長い見出しでも読み方が崩れません。
アクセシビリティ
axe-core で全ページ形状・ライトとダークの両テーマ・2つの画面幅を走査し、違反 0 を維持しています。
キーボードだけで操作できることは、別途数えて確かめました。ページ形状とテーマと画面幅の組み合わせ 36 通りを Tab だけで走査して 1,030 箇所に停止し、到達できない操作要素は 0 件、フォーカスリングが出ない停止も 0 件です。スタートメニューは Enter で開き、Escape で閉じ、閉じたあとフォーカスは開いたボタンに戻ります。テーマ切替は矢印キーで移動して Enter か Space で確定します。
文字と背景のコントラストは、計算値を読むのではなく実際に塗られた色をピクセルから測っています。配色を oklch() で定義しているため、getComputedStyle() は oklch(...) という文字列をそのまま返します。これを素朴に 3 つの数値として解釈すると、全部それらしく間違った数字が出ます。canvas に塗って読み戻すのが唯一正確な方法でした。
背景に動く作画が重なる箇所は、ページの背景色ではなくその作画の一番明るい部分に対して基準を満たすか確認しています。平均では足りていても、明るい筋の上に乗った文字が基準を割ることがあるためです。実際に 1 つ見つかり、トークンを調整して基準割れの画素を 10.82% から 0.00% にしました。
フォーカスリングは配色トークンとは別に用意しています。パステル系の色をライトテーマの背景に当てると約 1:1 になり、ライトテーマにはフォーカス表示が事実上存在しない状態だったためです。現在はライトで 6.64:1、ダークで 18.11:1 です。
測り方そのものと、測って初めて分かった思い違いは 少数派に届いているかは、測らないと分からない にまとめました。
パフォーマンス
本文の書体は元のファイルが 1,648 kB ありました。サイト内に実際に現れる文字だけを抜き出し、漢字より前の全域と実際に使う漢字の 2 ファイルに分けて unicode-range で振り分けることで、元の 4 分の 1 ほどに収めています。英語のページは前者だけを読み込みます。記事を書くたびに漢字が増えるので、この数字は固定ではありません。
トップのヒーローは 128 個のアニメーションを持っています。これが SVG の子ノードにあるためブラウザが合成処理に載せられず、画面外にスクロールしても CPU を 11.6% 使い続けていました。中位のスマートフォン相当の条件では 47.5% でした。見えていないあいだは止めるようにして 0.2% になりました。
ポインタの演出も、低性能な端末ほど高くつく作りになっていました。4 倍に遅くした CPU でメニューを開くのに 1,392ms かかっており、そのうち 888ms が「DOM が少しでも変わるたびに全要素の位置を測り直す」処理でした。本当に再配置が起きたときだけ全体を測るように分け、568ms になりました。
数字はいずれも実測した差です。速い環境で速いのは当たり前なので、CPU を 4 倍に遅くした状態と低速回線を基準にしています。
配信
配信は Cloudflare です。RSS フィードと llms.txt もビルドごとに自動生成されます。