2026/8/23 12:48:42
FEATURED · 精选文章 
ScrollingStackViewController生产环境使用最佳实践10条清单从show与remove抉择到延迟滚动技巧【免费下载链接】ScrollingStackViewControllerA view controller that uses root views of child view controllers as views in a UIStackView.项目地址: https://gitcode.com/gh_mirrors/sc/ScrollingStackViewControllerScrollingStackViewController 是一款 iOS 滚动容器框架它用UIStackView串联多个子视图控制器child view controller的根视图配合UIScrollView实现整页滚动。相比UITableViewController它更适合数量有限、但形态各异且可动态显隐的分段式页面。本文总结 10 条经过 Just Eat 生产验证的最佳实践从show 与 remove 的抉择到延迟滚动技巧帮你避开坑、写出稳定耐用的滚动页面。快速上手安装与继承支持 CocoaPodspod ScrollingStackViewController和 Swift Package Manager要求 iOS 12。核心类见 ScrollingStackViewController.swift官方示例见 ViewController.swift。class MyPage: ScrollingStackViewController { override func viewDidLoad() { super.viewDidLoad() add(viewController: headerVC) // 追加到末尾 add(viewController: bodyVC) } }一、布局基础清单 1~31️⃣ 子控制器必须能自撑高度这是全框架最关键的前提每个子视图控制器的根视图必须带垂直方向的高度约束否则UIStackView无法确定排列尺寸页面会塌成 0 高。约束不足时优先补intrinsicContentSize如标签、图片或显式高度。2️⃣ 分隔线用 spacingColor spacing别画 Cell 分割线示例中一行代码实现发丝分割线spacingColor .lightGray // 间隔处背景色 stackView.spacing 0.5 // 间隔宽度stackViewBackgroundView是垫在栈视图后面的背景层间隔处露出的就是它改颜色、改透明度如stackViewBackgroundView.alpha 0都不影响子视图。3️⃣ 边框与弹跳按需关掉borderColor/borderWidth用于卡片式描边如果内容不足一屏记得scrollView.alwaysBounceVertical false避免空弹跳。二、show 与 remove 的抉择清单 4~6这是生产环境里最核心的决策动态增删视图还是先加后显4️⃣ 首选策略一次性 add 全部再用 show/hide 显隐官方 README 给出的建议就是——把你计划用到的 VC 全部 add 进去之后只做 show/hide。理由show/hide/set(hidden:animated:)有完整的弹簧动画和完成回调状态切换平滑避免了频繁增删带来的索引错位、状态丢失子 VC 内部 UI 状态在 remove 后会彻底销毁代码量更少逻辑更线性。适合分段数量可控的场景——这正是该框架的设计定位。5️⃣ 动态插入用 insert Position 枚举少写索引数学确实需要动态插入时用 ScrollingStackViewController.swift 中定义的Position枚举比手算 index 更安全位置语义.start/.end首尾.index(2)指定下标越界会被钳制到末尾.after(vc)/.before(vc)相对某个兄弟 VC⚠️edgeInsets 陷阱带edgeInsets插入时子视图会被包进一个容器视图此时stackView里排列的是容器而非子视图本身。因此对这类 VC 做显隐要用show/hide且remove内部已做了容器 ≠ 子视图的双层清理见 remove 实现不要自己手动removeFromSuperview()。6️⃣ 一步到位show(insertIfNeededWith:)如果 VC 可能尚未插入用带插入参数的show重载它会先判断、缺了才插入、然后统一走 show 流程show(promoVC, insertIfNeededWith: (position: .after(headerVC), insets: .zero))注意源码注释传入nil时只会在该 VC 已存在的情况下显示不会自动插入——需要缺则插时务必传插入参数。测试覆盖了各种插入位置见 ScrollingStackViewInsertionLocationTests.swift。真正要销毁时再用remove(_:animated:completionHandler:)animated: true时它会先 hide 再 remove动画结束才真正摘除视图并调用 completion业务上依赖清理完成的逻辑要写在 completion 里。三、滚动与动画调优清单 7~107️⃣ 延迟滚动技巧scrollTo 会自动等布局完成scrollTo(viewController:)是生产中最容易踩坑的 API。看 源码实现如果此时maxOffsetY 0内容高度还没撑开或视图尚未排进栈里它不会立即滚动而是把滚动动作暂存挂到下一次viewDidLayoutSubviews之后再执行。 实践要点在viewDidLoad里刚 add 完就scrollTo完全可行——框架帮你排队不必手动DispatchQueue.main.async或延迟 0.1s 这种 hack。回调action会在真正滚动完成后触发。8️⃣ 理解 maxOffsetY 钳制滚到底部不越界scrollTo(view:) 私有实现 中目标 y 值会被钳制到maxOffsetYcontentSize.height - frame.height。所以滚动到最后一个子 VC 时自动停在可滚动的最底端不会出现目标在中间但页面停不住的问题。想滚到某分段但让它完整可见通常先滚动再配合分段自身高度即可。9️⃣ 定制动画覆盖 animate 与 scrollAnimate 两个闭包框架把动画策略做成可替换闭包默认是 0.5s / damping1 的弹簧动画显隐和 0.75s / damping0.7 的弹簧动画滚动animate { animations, completion in UIView.animate(withDuration: 1, animations: animations, completion: completion) }生产建议统一替换为团队设计规范时长注意animate里用了[weak self]的默认闭包写法替换时保持同样的弱引用习惯避免循环引用。 三个公开视图你的逃生舱scrollView、stackView、stackViewBackgroundView均为public let直接暴露。框架没覆盖到的需求如contentInset、contentOffset监听、stackView.distribution调整直接操作它们即可无需 fork 源码。生产检查清单上线前逐条自查✅ 每个子 VC 根视图都有可靠的高度约束✅ 分段数量可控优先 add 全部 show/hideremove 只用于真正销毁✅ edgeInsets 分段不做手动视图摘除统一走 show/hide/remove✅ 缺则插再显示的场景使用show(insertIfNeededWith:)✅ scrollTo 依赖其延迟机制回调写在 action 中✅ 动画时长符合设计规范闭包替换避免循环引用✅ 关闭多余弹跳alwaysBounceVertical false更多细节可阅读 ScrollingStackViewController.podspec 中的设计说明为何不用数据源模式以及示例工程里 SegmentController.swift 中分段自管理 UI 状态的完整写法。【免费下载链接】ScrollingStackViewControllerA view controller that uses root views of child view controllers as views in a UIStackView.项目地址: https://gitcode.com/gh_mirrors/sc/ScrollingStackViewController创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
ScrollingStackViewController生产环境使用最佳实践：10条清单从show与remove抉择到延迟滚动技巧
ScrollingStackViewController生产环境使用最佳实践10条清单从show与remove抉择到延迟滚动技巧【免费下载链接】ScrollingStackViewControllerA view controller that uses root views of child view controllers as views in a UIStackView.项目地址: https://gitcode.com/gh_mirrors/sc/ScrollingStackViewControllerScrollingStackViewController 是一款 iOS 滚动容器框架它用UIStackView串联多个子视图控制器child view controller的根视图配合UIScrollView实现整页滚动。相比UITableViewController它更适合数量有限、但形态各异且可动态显隐的分段式页面。本文总结 10 条经过 Just Eat 生产验证的最佳实践从show 与 remove 的抉择到延迟滚动技巧帮你避开坑、写出稳定耐用的滚动页面。快速上手安装与继承支持 CocoaPodspod ScrollingStackViewController和 Swift Package Manager要求 iOS 12。核心类见 ScrollingStackViewController.swift官方示例见 ViewController.swift。class MyPage: ScrollingStackViewController { override func viewDidLoad() { super.viewDidLoad() add(viewController: headerVC) // 追加到末尾 add(viewController: bodyVC) } }一、布局基础清单 1~31️⃣ 子控制器必须能自撑高度这是全框架最关键的前提每个子视图控制器的根视图必须带垂直方向的高度约束否则UIStackView无法确定排列尺寸页面会塌成 0 高。约束不足时优先补intrinsicContentSize如标签、图片或显式高度。2️⃣ 分隔线用 spacingColor spacing别画 Cell 分割线示例中一行代码实现发丝分割线spacingColor .lightGray // 间隔处背景色 stackView.spacing 0.5 // 间隔宽度stackViewBackgroundView是垫在栈视图后面的背景层间隔处露出的就是它改颜色、改透明度如stackViewBackgroundView.alpha 0都不影响子视图。3️⃣ 边框与弹跳按需关掉borderColor/borderWidth用于卡片式描边如果内容不足一屏记得scrollView.alwaysBounceVertical false避免空弹跳。二、show 与 remove 的抉择清单 4~6这是生产环境里最核心的决策动态增删视图还是先加后显4️⃣ 首选策略一次性 add 全部再用 show/hide 显隐官方 README 给出的建议就是——把你计划用到的 VC 全部 add 进去之后只做 show/hide。理由show/hide/set(hidden:animated:)有完整的弹簧动画和完成回调状态切换平滑避免了频繁增删带来的索引错位、状态丢失子 VC 内部 UI 状态在 remove 后会彻底销毁代码量更少逻辑更线性。适合分段数量可控的场景——这正是该框架的设计定位。5️⃣ 动态插入用 insert Position 枚举少写索引数学确实需要动态插入时用 ScrollingStackViewController.swift 中定义的Position枚举比手算 index 更安全位置语义.start/.end首尾.index(2)指定下标越界会被钳制到末尾.after(vc)/.before(vc)相对某个兄弟 VC⚠️edgeInsets 陷阱带edgeInsets插入时子视图会被包进一个容器视图此时stackView里排列的是容器而非子视图本身。因此对这类 VC 做显隐要用show/hide且remove内部已做了容器 ≠ 子视图的双层清理见 remove 实现不要自己手动removeFromSuperview()。6️⃣ 一步到位show(insertIfNeededWith:)如果 VC 可能尚未插入用带插入参数的show重载它会先判断、缺了才插入、然后统一走 show 流程show(promoVC, insertIfNeededWith: (position: .after(headerVC), insets: .zero))注意源码注释传入nil时只会在该 VC 已存在的情况下显示不会自动插入——需要缺则插时务必传插入参数。测试覆盖了各种插入位置见 ScrollingStackViewInsertionLocationTests.swift。真正要销毁时再用remove(_:animated:completionHandler:)animated: true时它会先 hide 再 remove动画结束才真正摘除视图并调用 completion业务上依赖清理完成的逻辑要写在 completion 里。三、滚动与动画调优清单 7~107️⃣ 延迟滚动技巧scrollTo 会自动等布局完成scrollTo(viewController:)是生产中最容易踩坑的 API。看 源码实现如果此时maxOffsetY 0内容高度还没撑开或视图尚未排进栈里它不会立即滚动而是把滚动动作暂存挂到下一次viewDidLayoutSubviews之后再执行。 实践要点在viewDidLoad里刚 add 完就scrollTo完全可行——框架帮你排队不必手动DispatchQueue.main.async或延迟 0.1s 这种 hack。回调action会在真正滚动完成后触发。8️⃣ 理解 maxOffsetY 钳制滚到底部不越界scrollTo(view:) 私有实现 中目标 y 值会被钳制到maxOffsetYcontentSize.height - frame.height。所以滚动到最后一个子 VC 时自动停在可滚动的最底端不会出现目标在中间但页面停不住的问题。想滚到某分段但让它完整可见通常先滚动再配合分段自身高度即可。9️⃣ 定制动画覆盖 animate 与 scrollAnimate 两个闭包框架把动画策略做成可替换闭包默认是 0.5s / damping1 的弹簧动画显隐和 0.75s / damping0.7 的弹簧动画滚动animate { animations, completion in UIView.animate(withDuration: 1, animations: animations, completion: completion) }生产建议统一替换为团队设计规范时长注意animate里用了[weak self]的默认闭包写法替换时保持同样的弱引用习惯避免循环引用。 三个公开视图你的逃生舱scrollView、stackView、stackViewBackgroundView均为public let直接暴露。框架没覆盖到的需求如contentInset、contentOffset监听、stackView.distribution调整直接操作它们即可无需 fork 源码。生产检查清单上线前逐条自查✅ 每个子 VC 根视图都有可靠的高度约束✅ 分段数量可控优先 add 全部 show/hideremove 只用于真正销毁✅ edgeInsets 分段不做手动视图摘除统一走 show/hide/remove✅ 缺则插再显示的场景使用show(insertIfNeededWith:)✅ scrollTo 依赖其延迟机制回调写在 action 中✅ 动画时长符合设计规范闭包替换避免循环引用✅ 关闭多余弹跳alwaysBounceVertical false更多细节可阅读 ScrollingStackViewController.podspec 中的设计说明为何不用数据源模式以及示例工程里 SegmentController.swift 中分段自管理 UI 状态的完整写法。【免费下载链接】ScrollingStackViewControllerA view controller that uses root views of child view controllers as views in a UIStackView.项目地址: https://gitcode.com/gh_mirrors/sc/ScrollingStackViewController创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
