Illustrator スクリプト｜文字と背景のコントラスト比を一括チェック

全テキストの文字色×背景色のコントラスト比を WCAG 基準で一括判定。未達を一覧化して選択。

Adobe Illustrator 用スクリプト（.jsx）1本。1ファイル＝1機能、ダイアログの「使い方」ボタンで手順が読めます。

■ できること

ドキュメント内の全テキストフレームについて、文字色と背後の背景色から WCAG 2.x のコントラスト比（相対輝度ベース）を算出し、基準（AA/AAA）を満たしているかを一覧化します。読み取り専用です（何も変更しません）。

■ 使い方

1. 基準（AA/AAA）と、大文字とみなすサイズ閾値(pt)を必要に応じて設定

2. [チェック実行] をクリック

3. 一覧（内容・文字色・背景色・比率・判定）を確認し、行を選んで [該当を選択] で対象テキストを選択

4. 「該当テキストに赤枠の注釈を付ける」をONにして再実行すると、NG項目に赤枠が別レイヤー（`_コントラストNG`）に描画されます。[注釈を消去] でいつでも削除できます

5. 必要なら [レポートを保存] でテキストとして書き出し

■ オプション

- 基準: AA（既定）／AAA

- 大文字とみなすサイズ閾値(pt、既定18。size>=14かつフォント名にBold/Heavy/Blackを含む場合も大文字扱い)

- 背景が不明瞭（グラデーション／画像／複数色混在の文字）な項目も一覧に出す（既定ON、「要目視確認」として表示）

- 該当テキストに赤枠の注釈を付ける（既定OFF。別レイヤー `_コントラストNG` に非破壊で追加、[注釈を消去]で削除）

■ 注意

読み取り専用です（注釈の描画・消去以外は何も変更しません）。背景色の判定は「対象テキストより背面にあり、bounds が重なる、走査順で直近の単色塗りオブジェクト」を採用する近似です（見つからなければ白地として扱います）。複雑な重なり方をしたレイアウトでは、実際の見た目と判定結果がずれることがあります。文字色は CMYKColor/GrayColor/SpotColor のいずれも `app.convertSampleColor` で RGB に変換してから計算します（CMYKの K100は印刷用ICCプロファイル経由の変換のため純黒(0,0,0)ではなく暗いグレーになりますが、コントラスト比の判定には支障ありません）。GradientColor/PatternColor の文字色・背景、複数色混在の文字、および画像・シンボル・メッシュ等（RasterItem/PlacedItem/SymbolItem/MeshItem/PluginItem/GraphItem）が直近の背景である場合は「要目視確認」（ambiguous）として扱い、比率は算出しません（黙って白地へフォールバックしません）。非表示のオブジェクト・Illustratorのガイドオブジェクト・クリッピングパス自体・完全に透明(不透明度0)なオブジェクト・自分が生成した注釈は背景候補から除外されます。クリップグループ内の要素は、祖先のクリップ範囲で絞り込んだ実効範囲で判定します（マスクの外にはみ出した部分は対象になりません）。「大きな文字」の判定はフレーム先頭文字のサイズ・フォント名による簡易判定です（文字ごとにサイズが混在するフレームでは正確でない場合があります）。大文字とみなすサイズ(pt)は0より大きく5000以下の数値で入力してください（不正な値では実行されません。既定値への無確認置換はしません）。ロック中/非表示のオブジェクトは選択できずスキップされます。出力レイヤー `_コントラストNG` は、同名の既存レイヤーが非表示・ロック・内容ありのいずれかの場合は再利用せず、連番付きの新規レイヤーを作ります。[注釈を消去] は本スクリプトが生成した注釈グループ（所有印付き）だけを削除し、同名レイヤーにあるユーザーの原稿は削除しません。[レポートを保存] は実行のたびに日時付きの新しいファイル名で保存します（既存ファイルを上書きしません）。

---

■ 動作環境

・Adobe Illustrator 2026（macOS）で自動テストと実機確認済み。

・Illustrator 2024／2025 および Windows は未検証です（同じ ExtendScript API のため動く想定）。

・Photoshop は不要です。

■ インストール

・.jsx をスクリプトフォルダ（macOS: /Applications/Adobe Illustrator 2026/Presets.localized/ja_JP/スクリプト/）にコピーして Illustrator を再起動 → ファイル＞スクリプト。

・コピーせずに ファイル＞スクリプト＞その他のスクリプト から実行することもできます。

・ダイアログの「使い方」ボタンで手順を確認できます。

■ 同梱物

・スクリプト（.jsx 1本）／README.md（インストール・使い方）／LICENSE.txt／CHANGELOG.md

■ お得なセット

・このスクリプトを含む「Illustrator 確認・入稿チェック スクリプト 8本パック」（¥2,980）もあります → https://totonoe-plugin.booth.pm/items/8892856

■ サポート

・不具合・要望は BOOTH のメッセージへ。再現データ（.ai）を添えていただけると早く直せます。

・アップデートは無償。BOOTH のダウンロードページから再ダウンロードしてください。

■ ライセンス

・購入者本人（法人は購入した1拠点）の商用・非商用利用 OK。再配布・転売不可。