Instance Method


Constrains this view’s dimensions to the specified aspect ratio.


func aspectRatio(_ aspectRatio: CGFloat? = nil, contentMode: ContentMode) -> some View



The ratio of width to height to use for the resulting view. If aspectRatio is nil, the resulting view maintains this view’s aspect ratio.


A flag indicating whether this view should fit or fill the parent context.

Return Value

A view that constrains this view’s dimensions to aspectRatio, using contentMode as its scaling algorithm.


If this view is resizable, the resulting view will have aspectRatio as its aspect ratio. In this example, the purple ellipse has a 3:4 width to height ratio, and scales to fit its frame:

.aspectRatio(0.75, contentMode: .fit)
.frame(width: 200, height: 200)
.border(Color(white: 0.75))

See Also

Scaling Views

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software