この記事はCodexに全部任せて書かれています!
概要
黒一色のSVGアイコンをCSSの filter プロパティで着色したところ、PCブラウザとiPhoneのSafari/Chromeで異なる色として描画される事象が発生しました。
端末ディスプレイ上の見え方だけでなく、スクリーンショットから取得したRGB値にも差があったため、True ToneやNight Shiftなどの画面表示設定だけが原因ではありません。ブラウザがスクリーンショットへ出力する前の描画処理で差が生じていました。
対策として、複数のfilter関数を連結して色を近似する方式をやめ、SVGをCSS maskとして利用し、currentColor で色を直接描画する方式へ変更しました。
発生した現象
対象は、複数画面で共有しているナビゲーションの単色SVGアイコンです。元のSVGは黒一色で、通常時と選択時の色をCSSから切り替える構成でした。
確認された現象は次のとおりです。
- PCブラウザでは意図した色に近い状態で表示される
- iPhoneではSafariとChromeの両方でPCとは異なる色になる
- ラベル文字とアイコンへ同じ色を意図していても、iPhoneでは色が揃わない
- iPhoneのスクリーンショットから取得したRGB値もPCと異なる
問題が起きた実装
元の実装では、黒いSVGを <img> として表示し、複数のCSS filter関数を連結して目的色へ近づけていました。
.navigation-item {
--icon-filter: brightness(0) saturate(100%) invert(50%);
}
.navigation-item.is-active {
--icon-filter: brightness(0) saturate(100%) invert(35%) sepia(80%)
saturate(2000%) hue-rotate(230deg) brightness(80%) contrast(110%);
}
.navigation-icon {
filter: var(--icon-filter);
}
この方法はSVGの色を直接指定するものではありません。元画像の各画素へ色変換を順番に適用し、その計算結果として目的色に近い値を生成します。
原因
直接の原因は、表示色をカラートークンで指定せず、複数のfilter関数による近似計算へ依存していたことです。
CSS Filter Effects仕様では、filter関数は記述順に適用され、後続の関数は直前の処理結果を入力として使用します。また、CSSのfilter関数はsRGB色空間で動作することが定められています。
今回のように、次の処理を多数連結すると、各段階の中間値が後続処理へ引き継がれます。
brightness()invert()sepia()saturate()hue-rotate()contrast()
特に大きな値の saturate() や、処理の最後に適用する contrast() は、中間値の小さな違いを最終的なRGB値へ反映させやすくなります。
ブラウザやOSの実装では、画像バッファの精度、ハードウェアアクセラレーション、GPU合成、量子化、丸めなどの内部処理が異なる可能性があります。複数段階の近似変換へ依存すると、こうした実装差の影響を受けやすくなります。
なぜiPhoneだけ違って見えたのか
AppleのSafari向け資料では、CSS filterはハードウェアアクセラレーションされ、複数のfilterを連結できる機能として説明されています。このため、同じCSSであっても、PCとiOSで異なる描画・合成経路が使われる可能性があります。
ChromiumのiOS Web Layer資料では、標準的なiOS向けの構成において、BlinkではなくWebKitの WKWebView を利用することが説明されています。iPhoneのSafariとChromeで同じ傾向が確認されたことは、両者が共通して利用するiOS/WebKit側の描画経路で差が生じたという推定と整合します。
ただし、今回の確認だけでは、WebKit内部のどの処理で差が生じたかまでは特定できません。特定のWebKitバグに該当する証拠もないため、「iOS固有の既知バグ」とは断定していません。
また、iPhoneはDisplay P3などの広色域表示とカラーマネジメントに対応していますが、スクリーンショットのRGB値自体が異なっていたため、ディスプレイの色域や画面設定だけでは説明できません。広色域対応は描画環境の違いとして関係する可能性がありますが、中心的な問題は複合filterによる色計算でした。
対策
複合 filter を廃止し、SVGを形状を定義するmaskとして使用しました。実際の表示色には currentColor を使い、親要素の color をそのまま描画します。
.navigation-item {
color: var(--muted-color);
}
.navigation-item.is-active {
color: var(--brand-color);
}
.navigation-icon {
width: 30px;
height: 24px;
background-color: currentColor;
-webkit-mask: var(--icon-mask) center / contain no-repeat;
mask: var(--icon-mask) center / contain no-repeat;
}
<span class="navigation-item is-active">
<span class="navigation-icon" style="--icon-mask: url('/images/navigation-icon.svg')"></span>
<span class="navigation-label">メニュー</span>
</span>
この構成では、SVGは透明部分と不透明部分を決めるためだけに使われます。アイコンの色は background-color: currentColor で直接描画されるため、複数段階の色変換がありません。
ラベルとアイコンが同じ color を継承することで、両者の色の正本も1つになります。
この対策が適している条件
CSS maskによる着色は、次のようなアイコンに適しています。
- 単色のSVG
- 状態に応じて1色だけ切り替えるアイコン
- ラベル文字とアイコンを同じ色にしたいUI
-
currentColorやデザイントークンで色を統一したいUI
一方、次のようなSVGへはそのまま適用できません。
- 複数色を使用するSVG
- グラデーションを含むSVG
- 色ごとに意味を持つ図やロゴ
- 元画像の色を維持する必要がある画像
maskは基本的に形状と透明度を利用するため、元の複数色は保持されません。
確認方法
同様の問題を調査するときは、次の順番で確認すると原因を切り分けやすくなります。
- SVG内部の
fill、stroke、透明度を確認する - SVG内部の色か、CSS
filterの結果かを確認する - 適用されているfilter関数と順序を確認する
- PCと実機で同じ画面をスクリーンショットにする
- アンチエイリアスの影響を避け、塗りの中央部分のRGB値を比較する
- mask方式へ変更した後、同じ条件でRGB値を再測定する
輪郭付近の画素はアンチエイリアスによって背景色と混ざるため、端末間で比較するときはアイコン内部の不透明な中央部分を測定します。
確認できたことと未確認事項
確認できたこと
- PCとiPhoneでスクリーンショットのRGB値が異なった
- iPhoneのSafariとChromeで同じ傾向が発生した
- 元のSVGは単色で、目的色は複合filterによって生成していた
- filter関数を連結せず、maskと
currentColorで同じ表示要件を実装できる - 静的解析、テンプレートコンパイル、フロントエンドビルドを通過した
未確認事項
- WebKit内部で差が生じた具体的な処理と数値精度
- 特定のWebKit既知バグへの該当有無
- 検証端末ごとのブラウザエンジン構成
- すべてのiOS/ブラウザバージョンで同じ差が発生するか
- mask方式へ変更した後の全対象端末におけるRGB値の完全一致
再発防止
- ブランドカラーを複合filterで近似生成しない
- 単色アイコンは
currentColor、inline SVG、CSS mask、状態別画像の順に検討する - 文字とアイコンの色は、同じデザイントークンを正本にする
- build成功を実機上の色一致とみなさない
- PCだけでなく、対象となるiOS端末でもスクリーンショットのRGB値を確認する
- mask方式を複数色SVGへ無条件に適用しない
まとめ
CSS filter は画像の色を手軽に変更できますが、多数のfilter関数を連結して特定のブランドカラーを再現する用途では、ブラウザやOSの描画実装差を受ける可能性があります。
単色SVGであれば、SVGをmaskとして使用し、currentColor で色を直接指定する方が、色の正本を明確にでき、端末間の差が生じる要因も減らせます。
今回の事例では、iPhone固有の内部バグを完全に特定したわけではありません。確定しているのは、複合filterによる近似色が端末間で一致しなかったことと、その近似計算を避ける構造へ変更できたことです。
参考資料
- W3C Filter Effects Module Level 1 — filter関数の適用順とsRGBでの処理
- Apple Safari CSS Visual Effects Guide: Using CSS Filters — SafariにおけるCSS filterとハードウェアアクセラレーション
- Chromium: iOS Web Layer — iOS向けChromiumのWeb描画構成
- WebKit: Improving Color on the Web — WebKitのカラーマネジメントと広色域対応
- W3C CSS Masking Module Level 1 — CSS maskの仕様
-
W3C CSS Color Module Level 4: currentColor —
currentColorの仕様