検証手順¶
変更後は npm run check → npm run build → npm run qa:built を実行します。ブラウザー検査の準備と用途は以下のとおりです。
CSSの管理と変更前後の比較¶
主要な文字サイズは src/styles/tokens.css の :root で管理しています。--text-body は本文、--text-table は表、--text-list は一覧や関連ページ、--text-ui はナビゲーション、--text-footer はフッターに使用します。標準のルート文字サイズ16pxでは本文はPC18px/スマートフォン17px、表は17px/16pxです。700px以下の画面では同じファイルのメディアクエリー内で変数を切り替えます。
配色・文字サイズは tokens.css、共通のフォーカス・はみ出し対策は base.css で定義します。配色・操作の基準はデザイン方針を参照してください。共通スタイルは src/layouts/Layout.astro が読み込む src/styles/global.css、ページ固有のスタイルは home.css・interior.css・news.css・error.css に分けています。ページ固有のCSSは使用するページやコンポーネントから読み込みます。Tailwind v4のクラス検出対象は src/ 配下に限定し、移行元アーカイブ・ドキュメント・検証スクリプトを対象から除いています。
CSS変更前後の表示を比較する場合は、変更前のソースで npm run build → node scripts/qa-css.mjs before、変更後のソースで npm run build → node scripts/qa-css.mjs after を実行します。ビルド済みの dist/ を一時的なローカルサーバーで配信し、比較結果を qa-artifacts/css-optimization/ に保存します。別途開発サーバーを起動する必要はありません。Windows版Chromeの標準インストール先を使用します。
全固定ページ・お知らせ一覧/記事・404ページについてPC/スマートフォンの算出スタイルと要素の位置・寸法を比較し、主要ページのスクリーンショットとメニュー・スライド操作も確認します。外部通信は遮断し、Googleマップのiframe内部は画像比較から除外しますが、iframe自体の位置・寸法は比較します。CSS容量・未使用量はChromeのCoverageによるローカル測定で、Lighthouseのスコア測定とは異なります。
WebP画像¶
npm run dev・npm run build・npm run build:preview の開始時に scripts/optimize-images.mjs が配信用WebPを生成します。手動で生成する場合は npm run images:optimize を実行します。変換にはプロジェクトの開発依存 sharp を使用するため、画像編集ソフトやサーバーへの追加インストールは不要です。
原本は上書きしません。スライド3枚とサブページ背景は品質90、認証マーク・関連リンクのバナーは可逆圧縮です。画像の寸法・構図は変更しません。可逆圧縮で容量が増えたロゴ・署名・製品画面、favicon・GIFは元形式のままです。変換結果は qa-artifacts/image-optimization.json に出力します。画像の追加時は、スクリプトの対象リストへの追加と表示側の参照変更が必要です。
ブラウザーでの表示・操作検査¶
別ターミナルで npm run dev を起動してから npm run qa を実行します。
npm run qa でPC・スマートフォンの表示、横はみ出し、内部リンク、ローカル画像、問い合わせフォームの表示、メニューとスライド操作、主要ページのWCAG 2 AA関連の自動チェックを実行します。Windowsでは標準インストール先のChrome、LinuxではPlaywrightのChromiumを使用します。実行ファイルは環境変数 CHROME_PATH、対象URLは QA_ORIGIN で変更できます。検査中は外部通信を遮断します。
CIでは npm run qa:built を使用します。ビルド済みの dist/ を空いているローカルポートで配信して検査し、終了後にサーバーを停止します。事前に npm run build を実行してください。Linuxでは npx playwright install --with-deps chromium でブラウザーと依存ライブラリーを導入します。
結果・スクリーンショットは qa-artifacts/ に保存します。自動検査だけで全てのアクセシビリティ適合を保証するものではありません。
機能別の検証¶
- 検索:
npm run build後にnpm run qa:search。検索結果、複数語検索、表記の正規化、履歴、読み込み失敗後の再試行、画面幅、ライト/ダークのアクセシビリティを確認します。サーバーは自動起動します。 - フォーム画面:別ターミナルで
npm run devを起動し、npm run qa:contact。外部サービスを代替し、実メールは送信しません。 - API:バックエンドの開発・テスト。
- セキュリティヘッダー:
npm run build後にnpm run qa:security。インラインスクリプトの不在、完全なCSP下での主要機能、GA・Turnstile・地図の代替通信、注入スクリプトの拒否を確認します。サーバーは自動起動し、実外部通信は行いません。CIでも実行します。NGINXへの設定反映と実通信の確認は専用手順に従います。 - CIでの検証:CI/CD運用手順。