Instance Method インスタンスメソッド

background(in:fillStyle:)

Sets the view’s background to a shape filled with the default background style.

Declaration 宣言 

func background<S>(in shape: S, fillStyle: FillStyle = FillStyle()) -> some View where S : Shape

Return Value 戻り値

A view with the specified shape drawn behind it.

Parameters パラメータ

shape

An instance of a type that conforms to Shape that SwiftUI draws behind the view using the background shape style.

fillStyle

The FillStyle to use when drawing the shape. The default style uses the nonzero winding number rule and antialiasing.

Discussion 議論

This modifier behaves like background(_:in:fillStyle:), except that it always uses the background shape style to fill the specified shape. For example, you can create a Path that outlines a trapezoid:


let trapezoid = Path { path in
    path.move(to: .zero)
    path.addLine(to: CGPoint(x: 90, y: 0))
    path.addLine(to: CGPoint(x: 80, y: 50))
    path.addLine(to: CGPoint(x: 10, y: 50))
}

Then you can use that shape as a background for a Label:


ZStack {
    Color.teal
    Label("Flag", systemImage: "flag.fill")
        .padding()
        .background(in: trapezoid)
}

Without the background modifier, the fill color shows through the label. With the modifier, the label’s text and icon appear backed by a shape filled with a color that’s appropriate for light or dark appearance:

A screenshot of a flag icon and the word flag inside a trapezoid; the

To create a background with other View types — or with a stack of views — use background(alignment:content:) instead. To add a ShapeStyle as a background, use background(_:ignoresSafeAreaEdges:).

See Also 参照

Background Elements

Adding a Background to Your View
Compose a background behind your view and extend it beyond the safe area insets.
func background<V>(alignment: Alignment, content: () -> V) -> some View
Layers the views that you specify behind this view.
func background<S>(S, ignoresSafeAreaEdges: Edge.Set) -> some View
Sets the view’s background to a style.
func background(ignoresSafeAreaEdges: Edge.Set) -> some View
Sets the view’s background to the default background style.
func background<S, T>(S, in: T, fillStyle: FillStyle) -> some View
Sets the view’s background to an insettable shape filled with a style.
func background<S>(in: S, fillStyle: FillStyle) -> some View
Sets the view’s background to an insettable shape filled with the default background style.
func background<S, T>(S, in: T, fillStyle: FillStyle) -> some View
Sets the view’s background to a shape filled with a style.
func listRowBackground<V>(V?) -> some View
Places a custom background view behind a list row item. あつらえのバックグラウンドビューをあるリスト行項目の後ろに置きます。