iOS 26 の「クリア」表示で、ウィジェットが真っ白になった——WidgetRenderingMode の3つのモード
iPhone のホーム画面は、アイコンやウィジェットの見た目を変えられます。通常のカラーのほかに、全体を1色に寄せる「色合い調整」や、iOS 26 で加わった、ガラスのように透ける「クリア」があります。
Sheet Widget では、この「色合い調整」や「クリア」にしたときに、ウィジェットが真っ白に飛んで、表が読めなくなる問題がありました。
ウィジェットの表示モードは3種類ある
ウィジェットがどの見た目で表示されているかは、SwiftUI の環境値 widgetRenderingMode で分かります。
| モード | Apple が説明する描画方法 |
|---|---|
.fullColor |
フルカラーで描画 |
.accented |
ビューをアクセント側と標準側のグループに分け、それぞれに色を適用 |
.vibrant |
彩度を落とした単色の表現から、背景に適応する効果を作る |
Apple の WidgetRenderingMode の説明に基づく分類です。ホーム画面の設定名と環境値を、すべてのOS・表示場所で一対一と決め付けず、実際に渡る値を確認します。
Sheet Widget は、セルの背景色や文字色を、スプレッドシートの書式どおりに描いています。ところが通常以外の描画では、元の色がそのまま保持されません。セルやグラフの背景を塗っていると、背景も線も文字も同じ1色になって一枚の塗りになり、線も文字も見えなくなっていました。
最初の修正は、モードを1つ見落としていた
直し方は、通常の表示以外では背景を塗らないことです。最初の修正では、これを .accented(色合い調整)のときだけに入れていました。
if renderingMode == .accented {
// 背景を塗らない
}
これで「色合い調整」は直りましたが、当時の検証で「クリア」として確認した表示への対応が不足していて、こちらでは白飛びが残っていました。保存した開発記録に、この見落としと修正の経緯が残っています。
修正:通常以外は、まとめて扱う
最終的には、「通常(.fullColor)以外」という条件に直して、両方をまとめて扱うようにしました。
@Environment(\.widgetRenderingMode) private var renderingMode
private var backgroundColor: Color {
if renderingMode != .fullColor { return .clear } // 通常以外は塗らない
return model.backgroundHex.map { Color(hex: $0) } ?? .white
}
この抜粋はグラフの背景色を決める処理です。表の方は、一番下の白い背景だけを消しても、セルごとの塗りが残ります。そのため、現在の GridWidgetView では次の3か所に同じ条件を適用しています。
| 描画する場所 | .fullColor |
それ以外 |
|---|---|---|
| 表が領域を埋めないときの余白 | 設定した背景を描く | 背景を描かない |
| 表全体の既定背景 | 白を描く | 白を描かない |
| 色の付いた各セル | セルの背景色を描く | セルの背景色を描かない |
セルの背景を描く箇所は、現在のコードでは次の条件です。
if !accented, let bg = cell?.backgroundColor, !bg.isEffectivelyWhite {
ctx.fill(Path(rect), with: .color(bg.color))
}
このコード内の accented は名前に反して .accented だけではなく、renderingMode != .fullColor を意味します。罫線を描く drawBorders(...) はこの条件の外にあり、テキストも別の層で描画しています。表全体を非表示にするのではなく、背景の塗りだけを抑える実装です。
2026年10月16日の確認は、保存した不具合対応記録と、表・グラフの現在のコードを照合したものです。今回実機・シミュレータで再撮影した比較画像はありません。OS側の色変換後に罫線や文字が十分見えるかは、各表示モードでの目視確認が必要で、コードの分岐だけでは保証できません。
確認の仕方
ホーム画面の見た目は、ホーム画面の何もないところを長押し →「編集」→「カスタマイズ」から切り替えられます。ウィジェットを作ったら、次の3つで表示を確かめるようにしています。
- 通常(ライト・ダーク)
- 色合い調整
- クリア
色をたくさん使うウィジェットほど、通常以外の表示で崩れやすいので、色のある表やグラフを表示するアプリでは特に注意が必要です。
Sheet Widget は App Store で公開しています。