跳到主要内容

SwiftUI Inspector:同一组编辑控件,宽屏用侧栏,窄屏用弹层

· 阅读需 4 分钟
GoSwiftUI
goswiftui.com

给当前选中的内容加一组编辑控件,不一定要分别做一套 iPad 侧栏和一套 iPhone 弹层。Natascha Fadeeva 介绍了 SwiftUI 的 inspector,以及为什么还要在目标系统上验证关闭和调整大小的行为。

本文是中文摘要解读,并非完整译文。

面板呈现交给系统,编辑状态留在主界面​

inspector(isPresented:content:) 从 iOS 17 开始可用。传入一个布尔绑定控制开关,并提供面板内容。水平空间宽裕时,SwiftUI 可以把它放在尾侧栏;空间紧凑时,则可以适配为 sheet。同一组控件不必因为设备型号而维护两份。

以图片编辑器为例,主界面可以持有当前选中的图层与裁剪参数,检查器只负责显示和编辑它们。这样即使窗口变窄,面板换了呈现方式,编辑对象也不必跟着换。这个例子是本站补充的设计建议。

列宽和弹层高度是两件事​

在检查器内容上用 presentationDetents([.medium, .large]),是给它以 sheet 呈现时提供两档可拖动的高度;它不会改变尾侧栏的宽度。要表达尾侧栏的首选宽度,应在面板内容上使用 inspectorColumnWidth。Apple 把它定义为首选宽度,并在 iOS 与 iPadOS 26 的发行说明中记录过宽度设置不生效的问题(145162377)。

原作者在 iOS 27.2 的测试中还遇到两个现象:下滑关闭后面板无法重新打开;拖动能切换高度,但通过绑定在代码里切换档位没有生效。显式关闭按钮将呈现绑定设回 false,在她的测试中可以正常再次打开。这些是原作者的测试观察,不代表所有版本或容器都会出现相同行为。

本站建议:把“能再次打开”列入验收​

  • 在宽、窄两种窗口下修改同一个值,再改变窗口宽度,确认改动仍在、选中对象没有跳回默认值。
  • 分别测试按钮关闭和手势关闭,每种方式关闭后都立即重开一次。若窄屏流程必须由代码可靠切换高度,而目标系统上的 inspector 未通过测试,再考虑该流程改用普通 sheet。
  • 在支持多窗口的设备上,也要测试应用已打开面板时拖动分屏分隔线。验证实际可用空间变化,比只按设备名称挑几台模拟器更有用。

本文没有复测原作者报告的系统行为。

博文来源​