appui
声明式原生界面、状态、布局、导航、控件、API 参考与示例。
开始
先建立 appui 的基本写法和质量标准。
指南
按真实界面结构学习状态、布局、导航、交互和性能。
appui 思维方式从命令式 UI 切到 State 驱动的声明式 View 树。状态管理State、ReactiveState、Timer 和批量更新的使用边界。布局系统用原生容器搭列表、表单、网格和可滚动页面。列表与表单List、ForEach、Form、Section、搜索、刷新和滑动操作。导航与页面结构TabView、NavigationStack、NavigationLink 和 toolbar 的组合方式。交互与回调按钮、输入、on_change、sheet 和行级回调的可靠写法。媒体与系统集成图片、相册、相机、地图、视频和 WebView 的页面模式。图表与绘图Chart、Canvas、DrawingContext 和 Path 的使用模式。深色模式与语义色语义颜色、材质背景、强制色彩方案和符号配色。动画animate、animation、transition、matched geometry 和 phase animator。热重载hot_reload 的启用方式、状态保留和调试边界。实时快路径高频状态更新、二进制属性通道和实时 UI 的边界。性能与实时界面普通 State、Timer、ReactiveState 和实时快路径的选择。
API 参考
按任务和组件查找公开 AppUI API。
入口函数run、dismiss、animate、bind、grid item 等模块级函数。状态 APIState、ReactiveState、NavigationPath、Timer 和 Ref。布局 APIStack、ScrollView、List/Form、Grid 和 GeometryReader。堆叠布局 APIVStack、HStack、ZStack、Lazy stacks、Spacer 和 Divider。滚动 APIScrollView、ScrollViewReader、滚动方向和定位锚点。网格 APILazyVGrid、LazyHGrid、Grid、GridRow 和轨道辅助函数。几何与特殊布局 APIGeometryReader、ViewThatFits、Group、Overlay 和 SafeAreaInset。控件 APIButton、TextField、Toggle、Picker、Slider 等控件签名。导航 APINavigationStack、NavigationLink、TabView、ToolbarItem。数据展示 APIList、ForEach、Form、Section、Table、ProgressView 等数据展示视图。呈现 APIalert、sheet、popover、confirmation dialog 和刷新动作。修饰符 API外观、布局、导航、交互和可访问性修饰符。环境值 APIenvironment_value、color_scheme、locale、layout_direction 和动态字体。媒体 APIImage、AsyncImage、PhotoPicker、CameraPicker、VideoPlayer、WebView 和 MapView。图表与画布 APIChart、Canvas、DrawingContext 和 Path。形状 APIRectangle、RoundedRectangle、Circle、Capsule、Ellipse、Color 和 ToolbarItem。
示例
可预览、可点击、布局稳定的完整页面样板。
示例索引经过统一布局和预览校验的完整页面样板。示例：待办列表原生列表、搜索、稳定 id 和行级按钮。示例：设置表单原生 Form、Section、输入控件和保存按钮。示例：紧凑仪表盘看板卡片、网格布局和真实交互。示例：原生列表详情NavigationStack、NavigationLink、搜索、刷新和滑动操作。示例：网络列表加载状态、刷新、错误展示和远端数据列表。示例：表格数据审核Table、筛选、批量动作和 iPhone fallback。示例：聊天界面消息列表、底部输入、安全区和滚动定位。示例：媒体采集相册PhotoPicker、CameraPicker、AsyncImage 和 ShareLink。示例：相册浏览器LazyVGrid、AsyncImage、PhotoPicker、详情导航和全屏预览。示例：原生表单设置Form、Section、输入控件、颜色选择和 storage 持久化。示例：图表与画布实验室Chart、Canvas、DrawingContext 和阈值可视化。示例：定位地图location 权限、坐标采样和 MapView 标记当前位置。示例：运动传感器仪表盘motion 姿态采样、气压高度、haptics 反馈和 Chart。示例：通知提醒notification 权限、本地提醒、取消操作和 storage 表单偏好。示例：血压分析HealthKit 授权、血压查询、摘要统计和趋势图。示例：安全凭据库Keychain 存储敏感字段，读取前使用系统验证。示例：实时活动与后台任务Live Activity、有限后台时间、后台刷新和完成通知。示例：快捷指令启动器运行快捷指令、打开 URL、系统设置入口和复制链接。示例：视频播放器VideoPlayer、片源搜索、播放状态和播放设置。示例：WebView 与系统分享WebView URL/HTML 预览、TextEditor 编辑和 ShareLink 分享。
速查
颜色、系统图标和从 ui 迁移的对照表。