ウィジェットの横幅が、アップデートで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 で公開しています。