Appearance Modifiers

Configure a view’s foreground and background styles, controls, and visibility.

Overview 概要

Use these modifiers to configure the appearance of a view, including the use of color and tint, and the application of overlays and background elements. Control the visibility of a view and specific elements within a view. Manage the shape and size of various controls.

To control rendering effects, like masking and compositing, see Graphics and Rendering Modifiers.

Topics 話題

Colors and Patterns

func foregroundStyle<S>(S) -> some View
Sets a view’s foreground elements to use a given style.
func foregroundStyle<S1, S2>(S1, S2) -> some View
Sets the primary and secondary levels of the foreground style in the child view.
func foregroundStyle<S1, S2, S3>(S1, S2, S3) -> some View
Sets the primary, secondary, and tertiary levels of the foreground style.
func foregroundColor(Color?) -> some View
Sets the color of the foreground elements displayed by this view. このビューによって表示される前景要素の色を設定します。

Tint

func tint(Color?) -> some View
Sets the tint color within this view.
func listRowSeparatorTint(Color?, edges: VerticalEdge.Set) -> some View
Sets the tint color associated with a row.
func listSectionSeparatorTint(Color?, edges: VerticalEdge.Set) -> some View
Sets the tint color associated with a section.
func listItemTint(Color?) -> some View
Sets a fixed tint color associated with specific content in a list.
func listItemTint(ListItemTint?) -> some View
Sets the tint effect associated with specific content in a list.

Light and Dark Appearance

func preferredColorScheme(ColorScheme?) -> some View
Sets the preferred color scheme for this presentation. 優先カラースキームをこの提示に対して設定します。

Foreground Elements

func border<S>(S, width: CGFloat) -> some View
Adds a border to this view with the specified style and width. 境界線をこのビューにこの指定されたスタイルと幅で加えます。
func overlay<V>(alignment: Alignment, content: () -> V) -> some View
Layers the views that you specify in front of this view.
func overlay<S>(S, ignoresSafeAreaEdges: Edge.Set) -> some View
Layers the specified style in front of this view.
func overlay<S, T>(S, in: T, fillStyle: FillStyle) -> some View
Layers a shape that you specify in front of this view.

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 background<S>(in: S, fillStyle: FillStyle) -> some View
Sets the view’s background to a shape filled with the default background style.
func listRowBackground<V>(V?) -> some View
Places a custom background view behind a list row item. あつらえのバックグラウンドビューをあるリスト行項目の後ろに置きます。

Control Configuration

func defaultWheelPickerItemHeight(CGFloat) -> some View
Sets the default wheel-style picker item height. 省略時の環形式ピッカー項目の高さを設定します。
func horizontalRadioGroupLayout() -> some View
Sets the style for radio group style pickers within this view to be horizontally positioned with the radio buttons inside the layout. ラジオグループ形式ピッカーに対するスタイルをこのビュー内で設定します、そのレイアウト（割り付け）内でラジオボタンが水平に置かれるようにします。
func controlSize(ControlSize) -> some View
Sets the size for controls within this view. このビュー内のコントロールそれらに対する大きさを設定します。
func buttonBorderShape(ButtonBorderShape) -> some View
Sets the border shape for buttons in this view.
func headerProminence(Prominence) -> some View
Sets the header prominence for this view.

Privacy and Redaction

Designing Your App for the Always On State
Customize your watchOS app’s user interface for continuous display.
func privacySensitive(Bool) -> some View
Marks the view as containing sensitive, private user data.
func redacted(reason: RedactionReasons) -> some View
Adds a reason to apply a redaction to this view hierarchy. ある改訂をこのビュー階層に適用する理由を加えます。
func unredacted() -> some View
Removes any reason to apply a redaction to this view hierarchy. 改訂をこのビュー階層に適用するあらゆる理由を除去します。

Visibility

func hidden() -> some View
Hides this view unconditionally.
func labelsHidden() -> some View
Hides the labels of any controls contained within this view. このビュー内に含まれるあらゆるコントロールのラベルを隠します。
func menuIndicator(Visibility) -> some View
Sets the menu indicator visibility for controls within this view.
func listRowSeparator(Visibility, edges: VerticalEdge.Set) -> some View
Sets the display mode for the separator associated with this specific row.
func listSectionSeparator(Visibility, edges: VerticalEdge.Set) -> some View
Sets whether to hide the separator associated with a list section.

See Also 参照

Configuring View Elements

Accessibility Modifiers
Make your SwiftUI apps accessible to everyone, including people with disabilities.
Text and Symbol Modifiers
Manage the rendering, selection, and entry of text in your view.
Auxiliary View Modifiers
Add and configure supporting views, like toolbars and context menus.