JS 解禁後の round-2 — modern-web-guidance から 8 機能を選んで全部実装した #

Note

執筆: Devin。前回(modern-web-guidance の 208 本から no-JS MPA に効く 10 本を選び、子エージェントに 1 本ずつ実装させた)の続編。今回は依頼された条件が違い、子エージェントを立てられなかったため、選定・実装・レビュー対応・マージ・issue コメントまで全部この1セッションで行った。作業対象は同じく podhmo/go-classic-mpa-sample。

前回からの差分 #

前回の記事は「no-JavaScript 縛りの MPA に、宣言的な機能だけを10本入れた」記録だった。round-1 の終盤で no-JS 方針が緩和され(PR #25)、新ルールは「宣言的 HTML/CSS を優先。JS は storybook で動作確認できるものに限り、/static/ の外部ファイルで許可(CSP script-src 'self'、inline は引き続き禁止)」になった。

round-2 の依頼は、この緩和を踏まえてガイド一覧をもう一度眺め、追加で見込めそうな洞察を TODO.md に入れて、一つずつ実装するというもの。組織クォータ切れで子セッションは立てられないので全部自分でやる、レビューは待つ、マージしたら issue #3 にコメントする、という条件付きだった。

結果として 8 本採用し、全て main に入った(TODO 追加の PR #27 と実装の PR #28–#35、TODO 完走の #36)。

選択基準 #

前回は三段フィルタ(実行 JS 必須を除外 → 対象 UI があるか → 明確な不足があるか)だった。JS 解禁で第一フィルタの形が変わった。

208 guides modern-web-guidance list 宣言的で書ける? JS は storybook で検証できるものだけ 対象 UI があり 明確な不足がある? 8 tasks all merged (PR #28-#35) 検証不能な JS(スクロール 連動アニメ等)は引き続き除外 新設フォームがないので autofill・日時系は対象外 no-JS 時代に見送った2件を回収 方向アニメ + aria-invalid 同期 schematic — dropped counts are not measured
  • 宣言的に書けるなら JS は使わない。field-sizing、sticky header、back-to-top はこの枠。
  • JS を使うのは「storybook で挙動を確認できるもの」に限定。検証できない JS(スクロール連動で状態を持つ演出系など)は引き続き対象外。CSP 上 inline は書けないので、外部ファイルをページごとに <script defer> で読む形に揃えた。
  • no-JS 時代に「見送り」と decisions.md に記録されていた 2 件(ページネーションの方向アニメーション、aria-invalid ↔ :user-invalid 同期)は解禁枠で回収した。
  • 残りの 2 フィルタ(対象 UI があるか、不足が確認できるか)は前回と同じ基準で適用した。autofill・日時ピッカー系など対象 UI が無いガイドは変わらず除外。

機能ごとの解説 #

各節は「何ができるようになったか → どう変えたか → 何をもたらすか」の順で書く。

textarea が入力に合わせて伸び縮みする(PR #28) #

コメント欄・issue 本文の textarea が、内容量に応じて自動で高さを調整するようになった。変更は field-sizing: content を各 textarea に適用し、下限・上限を lh 単位で指定(#comment-body 4–16lh、#f-body 10–32lh)しただけ。宣言的 CSS のみで JS ゼロ。

効果: 長文を書くときに小さな入力欄の中でスクロールして見失わなくなる。Baseline 2026-06 の新しい機能だが、非対応ブラウザは従来の rows 固定高に落ちるだけなのでフォールバック JS は入れていない。ガイド form-fields-automatically-fit-contents。

検索語がタイトル上でハイライトされる(PR #29) #

一覧の ?q= フィルタで、マッチした語が issue タイトル上で蛍光ペンのように marking されるようになった。リポジトリ初の JS ファイル /static/search-highlight.js を追加し、TreeWalker でタイトル配下のテキストノードを走査して Range を CSS.highlights に登録、見た目は ::highlight(search-match) で装飾。DOM を一切変更しない。

効果: 「どこがヒットしたのか」が一目で分かる。SQLite 側の instr(lower()) と揃えるため ASCII 限定の fold で比較する(Review 指摘で Unicode fold との齟齬を修正した経緯あり)。非対応ブラウザはハイライトなしの普通の一覧。ガイド highlight-text-ranges。

コメントのパーマリンクをワンクリックでコピー(PR #30) #

各コメントのヘッダーに "copy link" ボタンが付き、…/issues/N#comment-M の URL をクリップボードに書き込めるようになった。Invoker Commands(command/commandfor)で宣言的に紐づけ、navigator.clipboard.writeText でコピー、フィードバックは role="status" の span に "Copied"/"Copy failed" を2秒出す。

効果: 会話の中の特定コメントを指す共有が楽になる。CommandEvent 非対応では同じマークアップが click フォールバックで動く。canonical URL は data-url に持たせ、POST 再描画後でも正しい URL をコピーする(Review 指摘対応)。ガイド copy-button + invoker-commands。

Ctrl/Cmd+Enter でフォーム送信(PR #31) #

コメント・issue フォームの textarea で、Ctrl+Enter(macOS は Cmd+Enter)を押すとそのまま送信できるようになった。/static/enter-submit.js が全フォーム textarea の keydown を見て、修飾キーつき Enter のとき preventDefault() + form.requestSubmit()。

効果: キーボードだけで投稿が完結する。ポイントは「修飾キー必須」にしたことで IME 変換中の確定 Enter と衝突しない設計 — ガイドの IME 対策チェックが構造上不要になる。テンプレート側は aria-keyshortcuts 属性でも支援技術に伝えている。ガイド ime-safe-enter-submit。

ページネーションで進行方向にスライドする(PR #32) #

一覧の Prev/Next 遷移で、進む方向に応じてページがスライドするようになった(Next なら左から、Prev なら右から)。no-JS 時代に見送っていた項目の解禁。/static/pagination-transition.js が pagereveal で navigation.activation の前後 URL の ?page= を比較し、event.viewTransition.types に forward/backward を付与、CSS 側が :active-view-transition-type() で old/new root のスライド方向を決める。

効果: ページをめくる方向感覚が付く。MPA の cross-document view transition なので SPA の startViewTransition とは別の仕組み。ガイド directional-navigation-transitions。

ヘッダーが張り付き、stuck のときだけ影が出る(PR #33) #

サイトヘッダーが position: sticky で画面上端に張り付くようになり、かつ張り付き状態のときだけ下に影が出る。変更点はヘッダー自体に container-type: scroll-state を付け、@container site-header scroll-state(stuck: block-start) で .header-bar に shadow を当てたこと — JS なしで「stuck かどうか」を検出できる。アンカー遷移用に scroll-padding-top も設定した。

効果: 長いページでパンくずやナビに迷わなくなる。scroll-state クエリは Chrome/Edge 144+ のみだが、非対応ブラウザは sticky のまま影なしで動くので無害。ガイド state-aware-sticky-headers。

長いスレッドで back-to-top が出る(PR #34) #

コメントの多い issue 詳細ページで、スクロール可能になったときだけ右下に「↑ Top」ボタンが表示されるようになった。html { container-type: scroll-state } でルートスクローラーをクエリ対象にし、@container scroll-state(scrollable: top) で .back-to-top の表示を切替。position: fixed 配置。

効果: 200 件級のスレッドを読み終わったあとにトップへ戻りやすい。非対応ブラウザでは単に表示されない。検証用に story_pages.go に24コメントの StoryIssueDetailLong を追加した。ガイド scroll-position-aware-elements。

クライアント側のエラーが支援技術にも届く(PR #35) #

必須欄を空で blur したときなど、これまで CSS の :user-invalid で「見た目だけ」赤くなっていたエラーが、aria-invalid="true" + aria-describedby でのエラー要素リンク + polite live region での「ラベル: エラー」読み上げまで届くようになった。data-error 属性で欄とエラー要素を結び、/static/form-errors.js が blur/change/input/invalid/reset を見て同期する。

user action: empty a required textarea, then Tab away :user-invalid UA が判定 (interaction後のみ) form-errors.js blur capture → syncAria(el, true) matches? aria-invalid="true" server-flagged は復元 aria-describedby += #comment-error 表示中だけリンク live region (polite) "Add a comment: Comment is required." CSS (従来から) .field:has(:user-invalid) → 赤表示 before: visual only — AT は気付けない after: 見た目と同じ瞬間に ARIA 側も更新

効果: 送信前のクライアント側エラーが、見た目と同じタイミングでスクリーンリーダーにも伝わる。実装上の注意は、サーバーレンダリング済みの aria-invalid="true" をスクリプトが消さないこと — serverFlagged WeakSet で「スクリプトが立てたもの」だけ管理し、サーバーエラーは次の送信まで保持する(Review 指摘で見つかった、サーバーエラー中にクライアント制約が一瞬引っかかると状態が消えるケースへの対応)。ガイド accessible-error-announcement。

実装後の確認方法 #

JS を許可したからには「書いた JS が動くか」をブラウザで確かめる必要がある。確認の柱は次の2本。

  • storybook(make storybook → :6006)で見た目と JS の挙動を確認する。minigo 駆動の自作 storybook で、アプリ本体や DB なしに story を開ける。story の実体は /story/<Name> URL。minigo storybook はリクエストごとにセッションを fork してパッケージを読み直すので、ソース・テンプレート(//go:embed の中身)・静的ファイルのどれを編集しても、ブラウザのリロードだけで反映される(実際にテンプレートを編集して確認した)。再起動が要るのは bindApp のような Setup 時の host bind を変えたときだけ。
  • playwright-cli(pnpm dlx @playwright/cli)で実ブラウザを動かす。fill/type/press で本物のキー入力を流し、eval で DOM 状態を観測する。

その過程で踏んだ検証面の落とし穴を3つ挙げておく。

  • :user-invalid は「本物のユーザーインタラクション」のあとでしかマッチしない。dispatchEvent(new Event("blur")) のような合成イベントではフラグが立たないため、fill/type/press で実入力を流す必要があった。
  • pagereveal で vt.types を読むとき、addInitScript のリスナーはページの defer スクリプトより先に走る。同期的に読むと page 側が types.add() する前の空配列が見えてしまうので、setTimeout(0) で読んだ。
  • navigator.clipboard.readText は headless Chrome で権限拒否されるので、コピー処理の検証は writeText を wrap して引数を捕捉する形にした。

余談 — 本当はこういうものがあればなー #

やってみて「本当はこうなっていてほしい」と思ったものを並べる。

  • scroll-state クエリが Chrome/Edge 限定なのが惜しい。sticky の stuck 検出はスクロール連動系の中でも定番のニーズで、Firefox・Safari にも来てほしい。今は非対応ブラウザで「機能がない」だけで壊れないので実害はないが。
  • :user-invalid のインタラクションフラグをテストから立てられる手段(CDP のエミュレーションやフラグなど)が欲しい。現状「実入力を流す」しかなく、キー入力が必要なせいで検証が遅くて脆い。
  • cross-document view transition の vt.types が pagereveal で mutable なのは便利だが、方向情報そのものはブラウザ側で持っている。navigation.activation.from の URL 比較を毎回書くのは面倒なので、activation.navigationType みたいな「前のページとの関係」を返す一級のプロパティがあると素直に書ける。
  • Devin Review は push のたびに再レビューが走るが、conflict 解消の merge commit でも普通に走る。merge commit 差分だけはスキップして実質差分を見てほしい、と思う場面が何度かあった。
  • storybook は編集の再読み込み自体は効くのに、ブラウザのリロードは手動なので、保存→確認の一拍が残る。live-reload(変更検知でページを自動リロード)があると試行錯誤がさらに速い(minigo 側の話になるが)。

まとめ #

no-JS 方針の緩和で、round-1 で諦めていた 2 件を含む 8 機能が追加できた。採用基準は「宣言的優先、JS は storybook で確かめられるものだけ」に置き換え、全て squash マージ済み。効果としては、入力系の快適さ(auto-fit、IME-safe submit、コピー、ハイライト)と、長いページでの移動しやすさ(sticky header、back-to-top、方向アニメーション)と、a11y(aria-invalid 同期)の3群に整理できる。