Swift Optional safeAreaInset(edge:alignment:spacing:content:)用法及代码示例

用法一

实例方法

safeAreaInset(edge:alignment:spacing:content:)

在修改后的视图上方或下方显示指定内容。

声明

func safeAreaInset<V>(
    edge: VerticalEdge,
    alignment: HorizontalAlignment = .center,
    spacing: CGFloat? = nil,
    content: () -> V
) -> some View where V : View

返回值

一个新视图，在修改后的视图上方或下方显示 content，通过垂直插入修改后的视图为 content 视图腾出空间，调整结果的安全区域以匹配。

参数

edge: 视图的垂直边插入 content 的高度，为 content 腾出空间。
spacing: 两个视图之间放置的额外距离，或 nil 以使用默认间距量。
alignment: 用于水平定位 content 的对齐指南。
content: 一个视图构建器函数，提供要在修改后的视图的插入空间中显示的视图。

详述

content 视图锚定到父视图中的指定垂直边，将其水平轴与指定的对齐指南对齐。修改后的视图插入 content 的高度，从 edge 开始，其安全区域增加了相同的数量。


struct ScrollableViewWithBottomBar: View {
    var body: some View {
        ScrollView {
            ScrolledContent()
        }
        .safeAreaInset(edge: .bottom, spacing: 0) {
            BottomBarContent()
        }
    }
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+, tvOS 15.0+, watchOS 8.0+

用法二

实例方法

safeAreaInset(edge:alignment:spacing:content:)

在修改后的视图旁边显示指定的内容。

声明

func safeAreaInset<V>(
    edge: HorizontalEdge,
    alignment: VerticalAlignment = .center,
    spacing: CGFloat? = nil,
    content: () -> V
) -> some View where V : View

返回值

在修改后的视图旁边显示 content 的新视图，通过水平插入修改后的视图为 content 视图腾出空间。

参数

edge: 视图的水平边插入 content 的宽度，为 content 腾出空间。
spacing: 两个视图之间放置的额外距离，或 nil 以使用默认间距量。
alignment: 用于垂直定位content 的对齐指南。
content: 一个视图构建器函数，提供要在修改后的视图的插入空间中显示的视图。

详述

content 视图锚定到父视图中的指定水平边，将其垂直轴与指定的对齐指南对齐。修改后的视图插入了 content 的宽度，从 edge 开始，其安全区域增加了相同的数量。


struct ScrollableViewWithSideBar: View {
    var body: some View {
        ScrollView {
            ScrolledContent()
        }
        .safeAreaInset(edge: .leading, spacing: 0) {
            SideBarContent()
        }
    }
}

可用版本

iOS 15.0+, iPadOS 15.0+, macOS 12.0+, Mac Catalyst 15.0+, tvOS 15.0+, watchOS 8.0+

相关用法

注：本文由纯净天空筛选整理自apple.com大神的英文原创作品 Optional safeAreaInset(edge:alignment:spacing:content:)。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。