9ura00

ウィジェットの横幅が、アップデートで22pt狭くなった——contentMarginsDisabled と GeometryReader の落とし穴

Sheet Widget は、スプレッドシートの表をウィジェットにそのまま描くアプリです。表の大きさがウィジェットの大きさに直結するので、数ポイントの違いがそのまま見た目に出ます。

あるアップデートで、ウィジェットの表が前のバージョン(1.0)より狭く見えるという問題が起きました。直すのに3回かかったので、保存した測定記録と現在の実装を照合して、その対応をまとめます。以下の寸法は当時の iPhone 12 の記録です。今回、元の測定用画像を使って再測定した値ではありません。

きっかけ:機種ごとの寸法を持つのをやめた

1.0 では、iPhone の機種ごとのウィジェットの大きさを、コードの中に定数で持っていました。これだと新しい機種が出るたびに追加が必要になるので、GeometryReader で実際の大きさを受け取って描く形に変えました。

1回目:22pt 狭くなった

GeometryReader の大きさをそのまま使うようにしたところ、1.0 より横幅が約22pt狭くなりました。iPhone 12 で測ると、1.0 では表の幅が 329.3pt だったのが、306.7pt になっていました。

原因は、iOS 17 から入ったウィジェットのコンテンツマージンです。iOS 17 以降のウィジェットは、標準で内側に余白(マージン)が付きます。このときのビュー構成では、GeometryReader に渡る領域も余白の内側になっていました。ビュー階層にかかわらず常に同じ値になる、という意味ではありません。

2回目:今度ははみ出した

余白をなくすために、ウィジェットに .contentMarginsDisabled() を付けました。

StaticConfiguration(kind: kind, provider: Provider()) { entry in
    SheetsWidgetEntryView(entry: entry)
}
.contentMarginsDisabled()

すると今度は、広くなりすぎて、ウィジェットの丸い角から表がはみ出すようになりました。測ってみると、ヘッダーが 330.7pt、表が 340.3pt で、本来はヘッダーの内側に収まるはずの表のほうが広くなっていました。余白がゼロになったことで、ウィジェットの外枠いっぱいまで描いてしまったためです。

3回目:実寸から固定の余白を引く

最終的には、.contentMarginsDisabled() で本当の大きさを受け取ったうえで、自分で決めた固定の余白(左右 4.5pt、上下 1.5pt)を引く形にしました。この値は、1.0 の iPhone 12 での寸法(枠 338×158pt、表 329×155pt)から逆算したものです。

/// 枠の内側へ寄せる量。1.0 の見た目(338×158 の枠に 329×155)から逆算した値。
private static let inset = CGSize(width: 4.5, height: 1.5)

var body: some View {
    GeometryReader { geo in
        let inner = CGSize(width: max(geo.size.width - Self.inset.width * 2, 0),
                           height: max(geo.size.height - Self.inset.height * 2, 0))
        content(fullSize: inner)
            .frame(width: inner.width, height: inner.height)
            .padding(.horizontal, Self.inset.width)
            .padding(.vertical, Self.inset.height)
    }
}

4.5pt・1.5pt は Sheet Widget のデザインに合わせた値で、他のアプリの推奨値ではありません。別サイズ・端末でも意図した余白になるかは、実際の表示で確認する必要があります。

保存した測定記録では、最後の修正で表がヘッダーの内側に収まっています。比較すると次のようになります。

当時の状態(iPhone 12) ヘッダー幅 表の幅 記録から分かること
1.0 記載なし 329.3pt 比較の基準
GeometryReader へ変更 記載なし 306.7pt 基準より22.6pt狭い
標準マージンだけ無効化 330.7pt 340.3pt 表がヘッダーより9.6pt広い
固定の余白を追加 332.7pt 331.3pt 表がヘッダーより1.4pt狭い

最後の表の幅は1.0と数値まで同じではありません。「同じ見た目に戻った」という当時の判断と、幅が完全に一致することは分けて考えます。枠からのはみ出しを直せた、というのがこの記録から確認できる結果です。

今回コードで確認した範囲

2026年10月16日に、現在の SheetsWidgetView でも上記の固定余白を引く処理と .contentMarginsDisabled() が使われていることを確認しました。338×158pt の領域なら、計算上の内側は 338 − 4.5 × 2 = 329pt、158 − 1.5 × 2 = 155pt です。これはコード上の領域計算で、スクリーンショットから測った幅とは別の値です。

今回の確認では実機・シミュレータを起動していません。別機種での丸角の見え方や、最新OSでの描画結果は、コードの確認だけでは判定していません。

教訓:数字で確かめる

3回とも、見た目だけでは「たぶん直った」と思える程度の差でした。毎回、実機のスクリーンショットを撮って、ヘッダーと表の幅を画素で測り、1.0 の値と比べることで、直ったかどうかを判断しました。

  • iOS 17 以降のウィジェットには、標準で余白がある
  • GeometryReader が受け取る領域は、余白を含むビュー構成と合わせて確認する
  • .contentMarginsDisabled() を使うなら、余白は自分で決めて引く
  • 見た目の調整は、実機の画像を測って数字で確かめる

ウィジェットのデザインを「前と同じ見た目のまま」作り直すときは、この余白の扱いに注意してください。Apple の contentMarginsDisabled() の説明でも、無効化した後の余白はアプリ側で管理するとされています。


Sheet Widget は App Store で公開しています。

← ブログの一覧へ