1 视图基础 on 编程那些事儿

1.1 声明自定义视图

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/declaring-a-custom-view

1.1 声明自定义视图

定义视图并把它们组装成视图层级。

概述

SwiftUI 提供了一种声明式的用户界面设计方式。在传统的命令式方式中，控制器代码不仅要负责实例化、布局和配置视图，还要随着条件变化不断更新它们。相反，在声明式方式中，你通过在层级中声明与界面目标布局相对应的视图，创建一份轻量的界面描述。随后由 SwiftUI 负责绘制和更新这些视图，以响应诸如用户输入或状态变化之类的事件。

1.2 Wishlist：在 SwiftUI 应用中规划旅行

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/wishlist-planning-travel-in-a-swiftui-app

1.2 Wishlist：在 SwiftUI 应用中规划旅行

构建一个旅行规划应用，把行程组织成集合，并跟踪活动的完成情况。

概述

Wishlist 示例应用通过把旅行计划分组到季节性的集合中，帮助人们整理旅行安排。在每个行程中，人们可以创建活动，并在探索过程中把它们标记为完成。应用通过成就徽章来奖励进展，跟踪诸如完成第一次旅行或在所有冒险中达成某个活动里程碑之类的节点。

1.4 无障碍修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.4 无障碍修饰符

让你的 SwiftUI 应用对所有人可用，包括有身体障碍的人。

概述

与所有 Apple UI 框架一样，SwiftUI 自带无障碍支持。框架会内省导航视图、列表、文本输入框、滑块、按钮等常见元素，并默认提供基本的无障碍标签和值。你无需做任何额外工作就能启用这些标准无障碍功能。

1.5 外观修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.5 外观修饰符

配置视图的前景与背景样式、控件以及可见性。

概述

用这些修饰符配置视图的外观，包括颜色与色调的使用、叠加层与背景元素的应用。你可以控制视图以及视图中特定元素的可见性，还可以管理各种控件的形状与大小。

1.6 文本与符号修饰符

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/view-text-and-symbols

1.6 文本与符号修饰符

管理视图中文本的渲染、选取和输入。

概述

SwiftUI 提供向用户显示文本的内置视图（例如 Text 和 Label），也提供从用户那里收集文本的内置视图（例如 TextField 和 TextEditor）。用文本与符号修饰符控制 SwiftUI 如何显示和管理这些文本。例如，你可以设置字体、指定文本布局参数，并说明预期接收哪种输入。

1.8 图表视图修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.8 图表视图修饰符

配置你用 Swift Charts 声明的图表。

概述

用这些修饰符配置你添加到 SwiftUI 应用中的 Chart 视图。

样式

chartBackground(alignment:content:) —— 为包含图表的视图添加背景。
chartForegroundStyleScale(_:) —— 配置图表的前景样式刻度。
chartForegroundStyleScale(domain:range:type:) —— 配置图表的前景样式刻度。
chartForegroundStyleScale(domain:type:) —— 配置图表的前景样式刻度。
chartForegroundStyleScale(domain:mapping:) —— 配置图表的前景样式刻度。
chartForegroundStyleScale(mapping:) —— 配置图表的前景样式刻度。
chartForegroundStyleScale(range:type:) —— 配置图表的前景样式刻度。
chartForegroundStyleScale(type:) —— 配置图表的前景样式刻度。
chartPlotStyle(content:) —— 配置图表的绘图区域。

3D 配置

chart3DCameraProjection(_:)
chart3DPose(_:) —— 关联一个绑定，当 3D 图表的姿态因交互而改变时更新它。
chart3DRenderingStyle(_:)

图例

chartLegend(_:) —— 配置图表的图例。
chartLegend(position:alignment:spacing:) —— 配置图表的图例。
chartLegend(position:alignment:spacing:content:) —— 配置图表的图例。

叠加层

chartOverlay(alignment:content:) —— 为包含图表的视图添加叠加层。

坐标轴

chartXAxis(_:) —— 设置 x 轴的可见性。
chartXAxis(content:) —— 配置该视图中图表的 x 轴。
chartXAxisStyle(content:) —— 配置图表的 x 轴内容。
chartYAxis(_:) —— 设置 y 轴的可见性。
chartYAxis(content:) —— 配置该视图中图表的 y 轴。
chartYAxisStyle(content:) —— 配置图表的 y 轴内容。
chartZAxis(_:) —— 设置 z 轴的可见性。
chartZAxis(content:) —— 配置该视图中 3D 图表的 z 轴。

轴标签

chartXAxisLabel(_:position:alignment:spacing:) —— 为该视图中的图表添加 x 轴标签。
chartXAxisLabel(position:alignment:spacing:content:) —— 为该视图中的图表添加 x 轴标签。
chartYAxisLabel(_:position:alignment:spacing:) —— 为该视图中的图表添加 y 轴标签。
chartYAxisLabel(position:alignment:spacing:content:) —— 为该视图中的图表添加 y 轴标签。
chartZAxisLabel(_:position:alignment:spacing:) —— 为该视图中的图表添加 z 轴标签。它只影响 3D 图表。

轴刻度

chartXScale(domain:range:type:) —— 配置图表的 x 刻度。
chartXScale(domain:type:) —— 配置图表的 x 刻度。
chartXScale(range:type:) —— 配置图表的 x 刻度。
chartXScale(type:) —— 配置图表的 x 刻度。
chartYScale(domain:range:type:) —— 配置图表的 y 刻度。
chartYScale(domain:type:) —— 配置图表的 y 刻度。
chartYScale(range:type:) —— 配置图表的 y 刻度。
chartYScale(type:) —— 配置图表的 y 刻度。
chartZScale(domain:range:type:) —— 配置 3D 图表的 z 刻度。
chartZScale(domain:type:) —— 配置 3D 图表的 z 刻度。
chartZScale(range:type:) —— 配置 3D 图表的 z 刻度。

符号刻度

chartSymbolScale(_:) —— 配置图表的符号刻度。
chartSymbolScale(domain:) —— 配置图表的符号样式刻度。
chartSymbolScale(domain:range:) —— 配置图表的符号样式刻度。
chartSymbolScale(domain:mapping:) —— 配置图表的符号刻度。
chartSymbolScale(mapping:) —— 配置图表的符号刻度。
chartSymbolScale(range:) —— 配置图表的符号样式刻度。

符号尺寸刻度

chartSymbolSizeScale(_:) —— 配置图表的符号尺寸刻度。
chartSymbolSizeScale(domain:range:type:) —— 配置图表的符号尺寸刻度。
chartSymbolSizeScale(domain:type:) —— 配置图表的符号尺寸刻度。
chartSymbolSizeScale(domain:mapping:) —— 配置图表的符号尺寸刻度。
chartSymbolSizeScale(mapping:) —— 配置图表的符号尺寸刻度。
chartSymbolSizeScale(range:type:) —— 配置图表的符号尺寸刻度。
chartSymbolSizeScale(type:) —— 配置图表的符号尺寸刻度。

线型刻度

chartLineStyleScale(_:) —— 配置图表的线型刻度。
chartLineStyleScale(domain:) —— 配置图表的线型刻度。
chartLineStyleScale(domain:range:) —— 配置图表的线型刻度。
chartLineStyleScale(range:) —— 配置图表的线型刻度。
chartLineStyleScale(domain:mapping:) —— 配置图表的线型刻度。
chartLineStyleScale(mapping:) —— 配置图表的线型刻度。

滚动

chartScrollPosition(initialX:) —— 设置沿 x 轴的初始滚动位置。一旦用户滚动该滚动视图，提供给该修饰符的值就不再有效。
chartScrollPosition(initialY:) —— 设置沿 y 轴的初始滚动位置。一旦用户滚动该滚动视图，提供给该修饰符的值就不再有效。
chartScrollPosition(x:) —— 关联一个绑定，当图表沿 x 轴滚动时更新它。
chartScrollPosition(y:) —— 关联一个绑定，当图表沿 y 轴滚动时更新它。
chartScrollTargetBehavior(_:) —— 设置可滚动图表的滚动行为。
chartScrollableAxes(_:) —— 配置该视图中图表的可滚动行为。

选取

可见范围

chartXVisibleDomain(length:) —— 设置 X 方向上可见范围的长度。
chartYVisibleDomain(length:) —— 设置 Y 方向上可见范围的长度。

交互

chartGesture(_:)

1.9 样式修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.9 样式修饰符

为不同类型的视图应用内置样式。

概述

SwiftUI 为某些种类的视图定义了内置样式，并会针对特定的呈现上下文选择合适的样式。例如，Label 可能显示为图标、字符串标题，或者两者都显示，具体取决于平台、视图是否出现在工具栏中等等。

1.10 布局修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.10 布局修饰符

通过调整视图的尺寸、位置、对齐、内边距等，告诉视图如何在视图层级中安排自己。

概述

用布局修饰符微调视图在视图层级中的摆放。你可以调整或约束视图的尺寸、位置和对齐方式，也可以在视图周围添加内边距，并指明视图如何与系统定义的安全区域交互。

1.11 图形与渲染修饰符

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/view-graphics-and-rendering

1.11 图形与渲染修饰符

影响系统绘制视图的方式，例如缩放或遮罩视图，或者应用图形效果。

概述

用这些视图修饰符应用许多通常与图形上下文关联的渲染效果，例如添加遮罩、创建合成。你既可以把这些效果应用到图形类视图（例如形状），也可以应用到任何其他 SwiftUI 视图。

1.12 输入与事件修饰符

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/view-input-and-events

1.12 输入与事件修饰符

为视图提供动作，以响应用户输入和系统事件。

概述

使用输入与事件修饰符可以为各种各样的用户输入或系统事件配置并提供处理器。例如，你可以检测和控制焦点、响应视图出现与消失等生命周期事件、管理键盘快捷方式等等。

1.13 搜索修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.13 搜索修饰符

让人们可以在你的应用中搜索内容。

概述

用搜索视图修饰符为应用添加搜索能力。更多信息参见搜索。

显示搜索界面

searchable(text:placement:prompt:) —— 把该视图标记为可搜索，这会配置搜索框的显示。
searchable(text:isPresented:placement:prompt:) —— 把该视图标记为可搜索，并可编程方式呈现搜索框。
searchPresentationToolbarBehavior(_:) —— 为在该视图内的任何 searchable 修饰符配置搜索工具栏的呈现行为。
searchToolbarBehavior(_:) —— 配置工具栏中搜索的行为。
searchSelection(_:) —— 把与最近一个 searchable 修饰符关联的搜索框选区绑定到给定的 TextSelection 值。

使用令牌搜索

searchable(text:tokens:placement:prompt:token:) —— 把该视图标记为可用文本和令牌搜索。
searchable(text:tokens:isPresented:placement:prompt:token:) —— 把该视图标记为可用文本和令牌搜索，并支持以编程方式呈现。

使用可编辑令牌搜索

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

提供搜索建议

searchSuggestions(_:) —— 配置该视图的搜索建议。
searchSuggestions(_:for:) —— 配置在该视图中如何显示搜索建议。
searchCompletion(_:) —— 当该视图用作搜索建议时，把一个完整构成的字符串与它的值关联起来。
searchable(text:tokens:suggestedTokens:placement:prompt:token:) —— 把该视图标记为可用文本、令牌和建议搜索。
searchable(text:tokens:suggestedTokens:isPresented:placement:prompt:token:) —— 把该视图标记为可用文本、令牌和建议搜索，并支持以编程方式呈现。

限制搜索范围

searchScopes(_:scopes:) —— 配置该视图的搜索作用域。
searchScopes(:activation::) —— 用指定的激活策略配置该视图的搜索作用域。

通过听写搜索

searchDictationBehavior(_:) —— 为 searchable 修饰符配置的任何搜索框设置听写行为。

1.14 呈现修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.14 呈现修饰符

定义视图在指定条件下要呈现的附加视图。

概述

使用呈现修饰符可以显示不同类型的模态呈现，例如提醒、浮层、工作表和确认对话框。

由于 SwiftUI 是声明式框架，你不需要在想呈现模态视图的那一刻调用某个方法。相反，你定义呈现的样子，以及 SwiftUI 应在什么条件下呈现它。SwiftUI 会检测该条件何时变化，并替你完成呈现。由于你为触发呈现的条件提供了一个 Binding，当用户关闭呈现时，SwiftUI 可以重置底层值。

1.15 状态修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.15 状态修饰符

访问存储，并向子视图提供配置数据。

概述

SwiftUI 提供了在应用中管理数据的工具。例如，你可以在视图层级中各视图共享的环境里存储值和对象。任何共享该环境的视图——通常是存储该项的视图的所有后代视图——都可以访问所存储的项。

1.16 技术专用修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.16 技术专用修饰符

添加修饰符，以定制其他 Apple 框架提供的 SwiftUI 视图。

概述

使用这些修饰符配置和定制你从其他 Apple 框架集成来的 SwiftUI 视图，例如来自 WebKit 的网页视图，或来自 MapKit 的地图。

1.17 已弃用的修饰符

Sat, 12 Sep 2026 12:47:47 +0800

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

1.17 已弃用的修饰符

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

概述

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

1.18 配置视图

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/configuring-views

1.18 配置视图

通过应用视图修饰符来调整视图的特征。

概述

在 SwiftUI 中，你把视图组装成一个层级，用来描述应用的用户界面。为了帮助你自定义应用视图的外观与行为，你使用视图修饰符。例如，你可以用修饰符：

1.19 减少视图修饰符的维护量

Sat, 12 Sep 2026 12:47:47 +0800

原文链接: https://developer.apple.com/documentation/swiftui/reducing-view-modifier-maintenance

1.19 减少视图修饰符的维护量

把经常复用的视图修饰符打包成自定义视图修饰符。

概述

为了获得一致的视图，你可能会在各处反复复用同一个视图修饰符或同一组修饰符。例如，你可能对应用中许多文本实例应用相同的字体和前景色，让它们看起来一致。遗憾的是，这会带来维护上的困难，因为哪怕是格式上很小的改动（比如换一个字号），都需要修改代码中许多不同的地方。