【Illustrator】コントラスト比を一括チェックするスクリプト|WCAG AA・AAA対応
- Digital800 JPY





Illustrator内の全テキストについて、コントラスト比を一括で算出するスクリプト(.jsx)です。文字色と背景色から比率を計算し、WCAG基準を満たすかどうかを判定します。アクセシビリティに配慮した入稿前チェックに使えます。 ■ 標準機能でやる場合との違い イラレにはコントラスト比を測る機能がありません。文字色と背景色を確認するには、スポイトツールでそれぞれの色を拾い、カラーパネルでRGB値を読み取ります。読み取った数値をコントラストチェッカーのツールに入力し、WCAGの基準と照らし合わせます。WCAG 2.xの基準は、通常の文字でAA 4.5:1・AAA 7:1です。大きな文字(18pt以上、太字なら14pt以上が目安)は、AA 3:1・AAA 4.5:1です。この確認を、ドキュメント内のテキストフレームの数だけ繰り返すことになります。このスクリプトを使えば、全テキストフレームの自動スキャンが可能です。文字色と背景色からコントラスト比を計算し、基準を満たすかどうかを一覧で確認できます。 ■ 使い方 1. 基準(AA/AAA)と、大文字とみなすサイズ閾値(pt)を必要に応じて設定します 2. 「チェック実行」をクリックします 3. 一覧(内容・文字色・背景色・比率・判定)を確認し、行を選んで「該当を選択」で対象テキストを選択します 4. 「該当テキストに赤枠の注釈を付ける」をオンにして再実行すると、NG項目に赤枠が別レイヤー(`_コントラストNG`)に描画されます。「注釈を消去」でいつでも削除できます 5. 必要なら「レポートを保存」でテキストとして書き出します ■ オプション ・基準: AA(既定)/AAA ・大文字とみなすサイズ閾値(pt、既定18。size>=14かつフォント名にBold/Heavy/Blackを含む場合も大文字扱い) ・背景が不明瞭(グラデーション/画像/複数色混在の文字)な項目も一覧に出す(既定ON、「要目視確認」として表示) ・該当テキストに赤枠の注釈を付ける(既定OFF。別レイヤー`_コントラストNG`に非破壊で追加、「注釈を消去」で削除) ■ 注意 読み取り専用のスクリプトで、注釈の描画と消去以外はドキュメントを変更しません。背景色の判定は近似です。採用するのは、対象テキストより背面にあり、バウンディングボックスが重なる、走査順で直近にある単色塗りオブジェクトです。該当するオブジェクトが見つからないときは、白地として扱います。複雑に重なったレイアウトでは、実際の見た目と判定結果がずれることがあります。 文字色がCMYKColor、GrayColor、SpotColorのいずれであっても、計算方法は共通です。`app.convertSampleColor`でRGBに変換してから算出します。CMYKのK100は、印刷用ICCプロファイル経由の変換によって純黒(0,0,0)ではなく暗いグレーになりますが、コントラスト比の判定には影響しません。 直近の背景がGradientColorやPatternColorの文字色・背景、複数色が混在する文字にあたる場合は、「要目視確認」として一覧に表示します。画像・シンボル・メッシュなどが背景の場合も同じです。該当する種類は、RasterItem、PlacedItem、SymbolItem、MeshItem、PluginItem、GraphItemです。これらは比率を算出せず、白地への読み替えもしません。 背景の判定からは、非表示のオブジェクトとIllustratorのガイドオブジェクトを除きます。クリッピングパス自体、不透明度0の完全に透明なオブジェクト、スクリプトが生成した注釈も除きます。クリップグループの中にある要素は、祖先のクリップ範囲で絞り込んだ実効範囲で判定するため、マスクの外にはみ出した部分は対象外です。 「大きな文字」の判定は、テキストフレーム先頭の文字のサイズとフォント名による簡易判定です。1つのフレームの中でサイズが混在していると、正確に判定できないことがあります。 大文字とみなすサイズ(pt)は、0より大きく5000以下の数値で入力してください。範囲外の値では実行されず、既定値への置き換えもしません。ロック中または非表示のオブジェクトは、選択できないため対象外です。 出力レイヤー「_コントラストNG」は、同名のレイヤーが非表示・ロック・内容ありのいずれかに該当すると再利用せず、連番付きの新しいレイヤーを作ります。「注釈を消去」は、このスクリプトが生成した注釈グループだけを削除し、同じレイヤーにあるほかの原稿は残します。「レポートを保存」は実行のたびに日時付きの新しいファイル名で保存するため、既存のファイルを上書きしません。 --- ■ 動作環境 ・Adobe Illustrator 2026(macOS)で自動テストと実機確認をしています ・Illustrator 2024/2025とWindowsは未検証です。同じExtendScript APIを使っているため、動く想定です ・Photoshopがなくても動きます ■ インストール .jsxファイルをIllustratorのスクリプトフォルダにコピーし、Illustratorを再起動すると「ファイル>スクリプト」に表示されます。macOSのスクリプトフォルダは次の場所です。 /Applications/Adobe Illustrator 2026/Presets.localized/ja_JP/スクリプト/ コピーせずに「ファイル>スクリプト>その他のスクリプト」から.jsxファイルを選んで実行することもできます。ダイアログの「使い方」ボタンを押すと、手順を確認できます。 ■ 同梱物 ・スクリプト(.jsx)1本 ・README.md(インストールと使い方) ・LICENSE.txt ・CHANGELOG.md ■ セット商品 このスクリプトを含む「確認・入稿チェックスクリプト8本パック」(¥2,980)もあります。ロゴの最小使用サイズ・セーフエリアをチェックするスクリプトや、バーコードのクリアゾーンをチェックするスクリプトと一緒に使えます。 https://totonoe-plugin.booth.pm/items/8892856 ■ サポート 不具合や要望は、BOOTHのメッセージでお知らせください。再現できるデータ(.ai)を添えていただけると、早く修正できます。アップデートは無償で、BOOTHのダウンロードページから再ダウンロードできます。 ■ ライセンス 購入者本人(法人の場合は購入した1拠点)が、商用・非商用を問わず使えます。再配布と転売はできません。




