SwiftUI’s format primitives typically don’t present relative sizing choices, e.g. “make this view 50 % of the width of its container”. Let’s construct our personal!
Use case: chat bubbles
Contemplate this chat dialog view for example of what I need to construct. The chat bubbles all the time stay 80 % as broad as their container because the view is resized:
Constructing a proportional sizing modifier
1. The Format
We will construct our personal relative sizing modifier on prime of the Format protocol. The format multiplies its personal proposed dimension (which it receives from its father or mother view) with the given elements for width and top. It then proposes this modified dimension to its solely subview. Right here’s the implementation (the total code, together with the demo app, is on GitHub):
/// A customized format that proposes a proportion of its
/// obtained proposed dimension to its subview.
///
/// - Precondition: should include precisely one subview.
fileprivate struct RelativeSizeLayout: Format {
var relativeWidth: Double
var relativeHeight: Double
func sizeThatFits(
proposal: ProposedViewSize,
subviews: Subviews,
cache: inout ()
) -> CGSize {
assert(subviews.rely == 1, "expects a single subview")
let resizedProposal = ProposedViewSize(
width: proposal.width.map { $0 * relativeWidth },
top: proposal.top.map { $0 * relativeHeight }
)
return subviews[0].sizeThatFits(resizedProposal)
}
func placeSubviews(
in bounds: CGRect,
proposal: ProposedViewSize,
subviews: Subviews,
cache: inout ()
) {
assert(subviews.rely == 1, "expects a single subview")
let resizedProposal = ProposedViewSize(
width: proposal.width.map { $0 * relativeWidth },
top: proposal.top.map { $0 * relativeHeight }
)
subviews[0].place(
at: CGPoint(x: bounds.midX, y: bounds.midY),
anchor: .heart,
proposal: resizedProposal
)
}
}
Notes:
-
I made the sort personal as a result of I need to management how it may be used. That is vital for sustaining the belief that the format solely ever has a single subview (which makes the mathematics a lot easier).
-
Proposed sizes in SwiftUI might be
nilor infinity in both dimension. Our format passes these particular values by means of unchanged (infinity occasions a proportion remains to be infinity). I’ll focus on beneath what implications this has for customers of the format.
2. The View extension
Subsequent, we’ll add an extension on View that makes use of the format we simply wrote. This turns into our public API:
extension View {
/// Proposes a proportion of its obtained proposed dimension to `self`.
public func relativeProposed(width: Double = 1, top: Double = 1) -> some View {
RelativeSizeLayout(relativeWidth: width, relativeHeight: top) {
// Wrap content material view in a container to ensure the format solely
// receives a single subview. As a result of views are lists!
VStack { // alternatively: `_UnaryViewAdaptor(self)`
self
}
}
}
}
Notes:
-
I made a decision to go together with a verbose identify,
relativeProposed(width:top:), to make the semantics clear: we’re altering the proposed dimension for the subview, which received’t all the time end in a unique precise dimension. Extra on this beneath. -
We’re wrapping the subview (
selfwithin the code above) in aVStack. This may appear redundant, but it surely’s vital to ensure the format solely receives a single component in its subviews assortment. See Chris Eidhof’s SwiftUI Views are Lists for an evidence.
Utilization
The format code for a single chat bubble within the demo video above appears like this:
let alignment: Alignment = message.sender == .me ? .trailing : .main
chatBubble
.relativeProposed(width: 0.8)
.body(maxWidth: .infinity, alignment: alignment)
The outermost versatile body with maxWidth: .infinity is accountable for positioning the chat bubble with main or trailing alignment, relying on who’s talking.
You may even add one other body that limits the width to a most, say 400 factors:
let alignment: Alignment = message.sender == .me ? .trailing : .main
chatBubble
.body(maxWidth: 400)
.relativeProposed(width: 0.8)
.body(maxWidth: .infinity, alignment: alignment)
Right here, our relative sizing modifier solely has an impact because the bubbles turn out to be narrower than 400 factors. In a wider window the width-limiting body takes priority. I like how composable that is!
80 % received’t all the time end in 80 %
If you happen to watch the debugging guides I’m drawing within the video above, you’ll discover that the relative sizing modifier by no means reviews a width larger than 400, even when the window is broad sufficient:
It’s because our format solely adjusts the proposed dimension for its subview however then accepts the subview’s precise dimension as its personal. Since SwiftUI views all the time select their very own dimension (which the father or mother can’t override), the subview is free to disregard our proposal. On this instance, the format’s subview is the body(maxWidth: 400) view, which units its personal width to the proposed width or 400, whichever is smaller.
Understanding the modifier’s conduct
Proposed dimension ≠ precise dimension
It’s vital to internalize that the modifier works on the idea of proposed sizes. This implies it relies on the cooperation of its subview to attain its objective: views that ignore their proposed dimension will probably be unaffected by our modifier. I don’t discover this significantly problematic as a result of SwiftUI’s total format system works like this. In the end, SwiftUI views all the time decide their very own dimension, so you possibly can’t write a modifier that “does the appropriate factor” (no matter that’s) for an arbitrary subview hierarchy.
nil and infinity
I already talked about one other factor to concentrate on: if the father or mother of the relative sizing modifier proposes nil or .infinity, the modifier will go the proposal by means of unchanged. Once more, I don’t suppose that is significantly dangerous, but it surely’s one thing to concentrate on.
Proposing nil is SwiftUI’s manner of telling a view to turn out to be its very best dimension (fixedSize does this). Would you ever need to inform a view to turn out to be, say, 50 % of its very best width? I’m unsure. Perhaps it’d make sense for resizable pictures and comparable views.
By the way in which, you would modify the format to do one thing like this:
- If the proposal is
nilor infinity, ahead it to the subview unchanged. - Take the reported dimension of the subview as the brand new foundation and apply the scaling elements to that dimension (this nonetheless breaks down if the kid returns infinity).
- Now suggest the scaled dimension to the subview. The subview would possibly reply with a unique precise dimension.
- Return this newest reported dimension as your individual dimension.
This means of sending a number of proposals to baby views is known as probing. A lot of built-in containers views do that too, e.g. VStack and HStack.
Nesting in different container views
The relative sizing modifier interacts in an attention-grabbing manner with stack views and different containers that distribute the obtainable area amongst their kids. I believed this was such an attention-grabbing subject that I wrote a separate article about it: How the relative dimension modifier interacts with stack views.
The code
The whole code is out there in a Gist on GitHub.
Digression: Proportional sizing in early SwiftUI betas
The very first SwiftUI betas in 2019 did embrace proportional sizing modifiers, however they had been taken out earlier than the ultimate launch. Chris Eidhof preserved a duplicate of SwiftUI’s “header file” from that point that reveals their API, together with fairly prolonged documentation.
I don’t know why these modifiers didn’t survive the beta section. The discharge notes from 2019 don’t give a cause:
The
relativeWidth(_:),relativeHeight(_:), andrelativeSize(width:top:)modifiers are deprecated. Use different modifiers likebody(minWidth:idealWidth:maxWidth:minHeight:idealHeight:maxHeight:alignment:)as a substitute. (51494692)
I additionally don’t bear in mind how these modifiers labored. They in all probability had considerably comparable semantics to my resolution, however I can’t make certain. The doc feedback linked above sound simple (“Units the width of this view to the desired proportion of its father or mother’s width.”), however they don’t point out the intricacies of the format algorithm (proposals and responses) in any respect.
containerRelativeFrame
Replace Might 1, 2024: Apple launched the containerRelativeFrame modifier for its 2023 OSes (iOS 17/macOS 14). In case your deployment goal permits it, this generally is a good, built-in different.
Be aware that containerRelativeFrame behaves in a different way than my relativeProposed modifier because it computes the dimensions relative to the closest container view, whereas my modifier makes use of its proposed dimension because the reference. The SwiftUI documentation considerably vaguely lists the views that rely as a container for containerRelativeFrame. Notably, stack views don’t rely!
Take a look at Jordan Morgan’s article Modifier Monday: .containerRelativeFrame(_ axes:) (2022-06-26) to be taught extra about containerRelativeFrame.
