9ura00

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 で公開しています。

← ブログの一覧へ