Skip to content

SwiftUI 组件库概览

SwiftUI 提供了丰富的 UI 组件,能够满足绝大多数应用的界面需求。为了提高开发效率,我们将常用组件进行归类整理,方便你在开发中快速查找与复用。


🔤 输入类组件

  • TextField:单行文本输入框,支持占位符、绑定状态等
  • SecureField:密码输入框,内容自动隐藏
  • TextEditor:多行文本编辑器,适合笔记、评论等内容输入

🔘 控件类组件

  • Button:按钮,支持各种样式、图标、操作绑定
  • Toggle:开关,用于布尔值切换
  • Picker:选择器,适合性别、分类等选项
  • Slider:滑动条,常用于音量、亮度调整
  • Stepper:步进器,用于数值加减控制

📄 显示类组件

  • Text:显示文本内容,支持字体样式、颜色等修饰
  • Image:显示本地或网络图片,支持缩放、圆角等效果
  • ProgressView:进度指示器,可用于加载状态展示
  • Label:图标 + 文本组合组件,适合列表项或按钮标题

📚 布局类组件

  • VStack / HStack / ZStack:垂直、水平、重叠布局
  • Spacer:自动填充空白空间,用于对齐和排版
  • Divider:分割线
  • GeometryReader:获取视图几何信息,实现响应式布局

🧱 容器类组件

  • List:列表视图,支持静态或动态数据展示
  • Form:表单视图,自动添加输入元素间距
  • NavigationStack:页面导航容器
  • ScrollView:滚动视图,支持垂直或水平滑动

✅ 使用建议

  • 尽量使用系统提供的组件,保证一致性与系统适配
  • 为常用组件封装自定义视图,提高复用性与可维护性
  • 通过 .modifier() 封装通用样式,减少重复代码

你可以在左侧目录中选择任意组件,查看更多使用示例与代码演示。