1.17 已弃用的修饰符

原文链接: https://developer.apple.com/documentation/swiftui/view-deprecated

1.17 已弃用的修饰符

查阅不再受支持的修饰符及其替代方案。

概述

请避免在你的应用中使用已弃用的修饰符。选择一个修饰符即可查看你应当改用的替代方案。

无障碍修饰符

• accessibility(label:) —— 为视图添加描述其内容的标签。
• accessibility(value:) —— 添加对视图所含值的文本描述。
• accessibility(hidden:) —— 指定是否在系统无障碍功能中隐藏该视图。
• accessibility(identifier:) —— 用指定的字符串标识该视图。
• accessibility(selectionIdentifier:) —— 为该视图的无障碍元素设置选取标识符。
• accessibility(hint:) —— 告诉用户执行该视图的动作之后会发生什么。
• accessibility(activationPoint:) —— 指定视图中发生激活的位置。
• accessibility(inputLabels:) —— 设置用户用于识别视图的备选输入标签。
• accessibility(addTraits:) —— 为视图添加给定特征。
• accessibility(removeTraits:) —— 从该视图移除给定特征。
• accessibility(sortPriority:) —— 设置该视图无障碍元素相对于同一层级其他元素的排序优先级。

外观修饰符

• colorScheme(_:) —— 设置该视图的配色方案。
• listRowPlatterColor(_:) —— 设置该视图放入列表时系统应用到行背景的颜色。
• background(_:alignment:) —— 把给定视图叠加到该视图之后。
• overlay(_:alignment:) —— 把一个次级视图叠加到该视图之前。
• foregroundColor(_:) —— 设置该视图所显示前景元素的颜色。
• complicationForeground() —— 把该视图提升为表盘复杂功能中的前景。

文本修饰符

• autocapitalization(_:) —— 设置是否对该视图应用自动大写。
• disableAutocorrection(_:) —— 设置是否对该视图禁用自动更正。

辅助视图修饰符

• navigationBarTitle(_:) —— 设置该视图导航栏中的标题。
• navigationBarTitle(_:displayMode:) —— 设置该视图导航栏中的标题和显示模式。
• navigationBarItems(leading:) —— 设置该视图的导航栏项。
• navigationBarItems(leading:trailing:) —— 设置该视图的导航栏项。
• navigationBarItems(trailing:) —— 配置该视图的导航栏项。
• navigationBarHidden(_:) —— 为该视图隐藏导航栏。
• statusBar(hidden:) —— 设置状态栏的可见性。
• contextMenu(_:) —— 为视图添加上下文菜单。

样式修饰符

• menuButtonStyle(_:) —— 设置该视图内菜单按钮的样式。
• navigationViewStyle(_:) —— 设置该视图内导航视图的样式。

布局修饰符

• frame() —— 把该视图放置在不可见边框内。
• edgesIgnoringSafeArea(_:) —— 改变视图的建议区域，使其延伸到屏幕安全区域之外。
• coordinateSpace(name:) —— 为视图的坐标空间命名，让其他代码可以基于该命名空间操作点、尺寸等度量。

图形与渲染修饰符

• accentColor(_:) —— 为该视图及它包含的视图设置强调色。
• mask(_:) —— 用给定视图的 alpha 通道遮罩该视图。
• animation(_:) —— 对该视图内所有可动画的值应用给定的动画。
• cornerRadius(_:antialiased:) —— 用指定的圆角半径把该视图裁剪到它的包围框内。

输入与事件修饰符

• dropDestination(for:action:isTargeted:) —— 定义拖放操作的目标，用一个你指定的闭包处理被拖放的内容。
• onChange(of:perform:) —— 添加当给定值变化时要执行的动作。
• onTapGesture(count:coordinateSpace:perform:) —— 添加当该视图识别到轻点手势时要执行的动作，并把这个交互的位置提供给该动作。
• onLongPressGesture(minimumDuration:maximumDistance:pressing:perform:) —— 添加当该视图识别到长按手势时要执行的动作。
• onLongPressGesture(minimumDuration:pressing:perform:) —— 添加当该视图识别到长按手势时要执行的动作。
• onPasteCommand(of:perform:) —— 添加为响应系统的「粘贴」命令而要执行的动作。
• onPasteCommand(of:validator:perform:) —— 添加为响应系统的「粘贴」命令而要执行的动作，并对条目进行校验。
• onDrop(of:delegate:) —— 定义与该视图尺寸和位置相同的拖放操作目标，其行为由给定委托控制。
• onDrop(of:isTargeted:perform:) —— 定义拖放操作的目标，用一个你指定的闭包处理被拖放的内容。
• focusable(_:onFocusChange:) —— 指定该视图是否可聚焦；如果可以，还添加当视图获得焦点时要执行的动作。
• onContinuousHover(coordinateSpace:perform:) —— 添加当指针进入、在视图边界内移动以及离开视图边界时要执行的动作。

视图呈现修饰符

• actionSheet(isPresented:content:) —— 当给定条件为 true 时呈现操作表单。
• actionSheet(item:content:) —— 用给定条目作为表单内容的数据源来呈现操作表单。
• alert(isPresented:content:) —— 向用户呈现提醒框。
• alert(item:content:) —— 向用户呈现提醒框。

搜索修饰符

• searchable(text:placement:prompt:suggestions:) —— 把该视图标记为可搜索，这会配置搜索框的显示。

标签页修饰符

• tabItem(_:) —— 设置与该视图关联的标签栏项。

生成图像的修饰符

• imagePlaygroundPersonalizationPolicy(_:) —— 决定是否支持在 playground 中使用人物形象的政策。

技术专用修饰符

• postToPhotosSharedAlbumSheet(isPresented:items:photoLibrary:defaultAlbumIdentifier:completion:) —— 呈现「添加到共享相簿」表单，允许用户把给定条目发布到共享相簿。
• offerCodeRedemption(isPresented:onCompletion:)
• subscriptionPromotionalOffer(offer:signature:) —— 选择要应用到顾客在订阅商店视图中进行购买时的促销优惠。