This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.
This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 57).
SwiftUI
使用 @expo/ui 构建原生 iOS 界面的 SwiftUI 组件。
iOS
tvOS
Included in Expo Go
SwiftUI 组件位于 @expo/ui/swift-ui 中,允许你使用 React Native 中的 SwiftUI 构建完全原生的 iOS 界面。
安装
Terminal
- npx expo install @expo/uiIf you are installing this in an existing React Native app, make sure to install expo in your project.
用法
使用 @expo/ui/swift-ui 中的组件时,需要将其包装在 Host 组件中。Host 是 SwiftUI 视图的容器。
import { Host, Button } from '@expo/ui/swift-ui'; export function SaveButton() { return ( <Host style={{ flex: 1 }}> <Button label="保存更改" /> </Host> ); }
更多信息请参阅以下资源:
Expo UI Swift UI 指南
了解 @expo/ui/swift-ui 的基础知识
使用 SwiftUI 扩展
创建可与 Expo UI 集成的自定义 SwiftUI 组件和修饰器。

Expo UI iOS Liquid Glass 教程
了解如何在你的 React Native 应用中使用新的 Expo UI 构建真正的 SwiftUI 视图。
可用组件
| 组件 | 描述 |
|---|---|
AccessoryWidgetBackground | 根据小组件的环境提供标准外观的自适应背景视图。 |
Alert | 用于呈现原生 iOS 警告对话框的警告组件。 |
BottomSheet | 从屏幕底部呈现内容的 BottomSheet 组件。 |
Button | 用于显示原生按钮的按钮组件。 |
ColorPicker | 用于选择颜色的 ColorPicker 组件。 |
ConfirmationDialog | 用于呈现确认提示的 ConfirmationDialog 组件。 |
ContextMenu | 用于显示上下文菜单的 ContextMenu 组件。 |
ControlGroup | 用于对交互式控件进行分组的 ControlGroup 组件。 |
DatePicker | 用于选择日期和时间的 DatePicker 组件。 |
DisclosureGroup | 用于显示可展开内容的 DisclosureGroup 组件。 |
Divider | 用于创建视觉分隔线的 Divider 组件。 |
Form | 用于以结构化布局收集用户输入的 Form 组件。 |
Gauge | 用于通过视觉指示器显示进度的 Gauge 组件。 |
Group | 用于对视图进行分组且不影响布局的 Group 组件。 |
Host | 用于在 React Native 中启用 SwiftUI 组件的 Host 组件。 |
HStack | 用于水平布局的 HStack 组件。 |
Image | 用于显示 SF Symbols 的 Image 组件。 |
Label | 用于显示带图标文本的 Label 组件。 |
LazyHStack | 用于延迟加载水平布局的 LazyHStack 组件。 |
LazyVStack | 用于延迟加载垂直布局的 LazyVStack 组件。 |
Link | 用于显示可点击链接的 Link 组件。 |
List | 用于显示可滚动项目列表的 List 组件。 |
Menu | 用于显示下拉菜单的 Menu 组件。 |
Namespace | 允许你在 SwiftUI 中创建命名空间的 Namespace 组件。 |
Overlay | 用于将内容叠加在其他视图之上的 Overlay 组件。 |
Picker | 用于从列表中选择选项的 Picker 组件。 |
Popover | 用于在浮动叠加层中显示内容的 Popover 组件。 |
ProgressView | 用于显示进度指示器的 ProgressView 组件。 |
RNHostView | 用于在 SwiftUI 中启用 React Native 视图的组件。 |
ScrollView | 用于显示可滚动内容的 ScrollView 组件。 |
Section | 用于在列表和表单中对内容进行分组的 Section 组件。 |
SecureField | 用于输入密码的 SecureField 组件。 |
Slider | 用于从一定范围内选择数值的 Slider 组件。 |
Spacer | 用于提供灵活间距的 Spacer 组件。 |
SwipeActions | 用于为行内容添加前导和尾随滑动操作的 SwipeActions 组件。 |
TabView | 用于显示分页或标签页内容的 TabView 组件。 |
Text | 用于显示样式化文本并支持嵌套文本的 Text 组件。 |
TextField | 用于输入文本的 TextField 组件。 |
Toggle | 用于显示原生切换开关的 Toggle 组件。 |
VStack | 用于垂直布局的 VStack 组件。 |
ZStack | 用于重叠布局的 ZStack 组件。 |