阅读 4129

官方文档不全?英文看着太累?我实现了 SwiftUI 所有控件的官方例子,解决你的烦恼~

在学习使用 SwiftUI 的时候,经常出现这样的一些问题:

  • 默默地啃苹果的英文文档,写的还不那么清楚...中途放弃...
  • 想实现一个功能,不知道 SwiftUI 是否提供,上网搜基本还是 UIKit 的教程。
  • 好不容易在 stackoverflow 上搜到一个用法,可是只有单独一段代码,看不出来效果,就只好自己单开一个页面试试,不行的话就接着找...
  • 有的博文是包含这个功能的,但是被紧紧地嵌在一个项目里,只能自己往外扣,扣得好心累...

为了解决这个问题,我结合 SwiftUI 的预览功能,把 SwiftUI 至今发布的 25 个控件的例子都做了出来,并配上了中文注释,放在了这里(SwiftUIViews)。例如,要学习 SwiftUI 的 ColorPicker 功能,如果直接看文档的话是这样的:

至少我看完还是不清楚这个选择颜色的 UI 控件具体有什么功能,能不能满足我的需要。我真的希望苹果能在代码例子下面放个效果图就好了...求人不如求己,所以我把官方例子以及变种都实现了出来,通过预览,我们就能清楚地看到控件的样子和功能了。所以现在,学习 ColorPicker 的体验变成了这样:

在上图中(由于 gif 压缩,实际效果会更好些),我们可以清楚地看到,supportsOpacity 是在什么位置控制透明度的选择的。

除此之外,对于一些常用的控件,文档里竟然完全没有介绍...例如常用的 List 的文档是这样的:

。。。文档同志,不是让你给我翻译一下 List 这个单词好不好...

为了帮助自己记忆,同时帮助大家学习,在 SwiftUIViews 这份总结中,我补充了这些缺失文档的控件的常见的和一些不那么常见的用法。在这里,List 的说明是这样的:

这份总结极大地帮助我了解了该如何使用 SwiftUI 的视图们,相信也可以帮到你~

目前这个项目已经完成了所有的控件视图(Text, Button 这种),之后应该会逐渐补上布局视图以及其他视图,也欢迎大家的指正和补充,也欢迎大家来点 star 呀~

文章分类
iOS
文章标签