TEQuickPageViewController 2.1.2

TEQuickPageViewController 2.1.2

测试已测试
Lang语言 Obj-CObjective C
许可证 MIT
发布了最新版本2015年11月

Tom Elliott 维护。



  • 作者:
  • Tom Elliott

UIPageViewController 的扩展,允许在 Storyboard 中直接添加视图到页面视图,无需任何额外的代码

只需在 Storyboard 中创建你的页面视图控制器,添加几个联合,你就有了一组工作的页面视图。

Pages in Storyboard

TEQuickPageViewController 支持翻页和滚动过渡类型,以及具有“中”脊位置的二维视图。

Curled Pages Scrolled Pages

本版本更改

查看 CHANGELOG.md,获取每个版本变更的完整列表。

安装

直接安装

要直接包含所需源代码,只需将这些文件添加到你的项目中

  • TEQuickPageViewController.h
  • TEQuickPageViewController.m
  • TEQuickPageViewSegue.h
  • TEQuickPageViewSegue.m

设置你的页面视图

首先,你需要准备你的 UIPageViewController

  • 在 Storyboard 中拖入一个 Page View Controller
  • 在页面视图控制器的 Identity 检查器中,将类设置为 TEQuickPageViewController

Identity Inspector Button

Setting a Custom Class

添加页面

要添加页面到你的页面序列,你需要将其连接到你的控制器或前面的页面

  • 在 Storyboard 中拖入一个 查看控制器
  • 在你页面视图控制器和新查看控制器之间添加一个 自定义 联合。

Initial Segue

  • 将联合的类设置为 TEQuickPageViewSegue并将 Identifier 设置为 "page"

Attribute Inspector Button

Configuring a segue

要添加第二个页面,只需将另一个查看控制器拖入你的视图,并添加一个具有相同设置的另一个自定义联合,这次从第一个页面开始。这将创建一个在 Storyboard 中的页面链。

A chain of two pages

其他功能

扩展视图(去除黑色条!)

你可能会注意到,当使用滚动过渡时,在视图底部出现了一个丑陋的黑色条。

The Ugly Black Bar

要解决这个问题,您可以设置您的 TEQuickPageViewController 来扩展整个视图中的页面。只需打开您的 TEQuickPageViewController 的属性检查器,并将 "扩展页面" 开启

The Ugly Black Bar

The Ugly Black Bar

恭喜!不再有丑陋的栏。当然,您可能需要更改滚动指示器的颜色

更改指示器颜色

在上面的扩展页面截图您可能已经看到,有 "指示器色调" 和 "指示器当前" 的颜色选项。

它们分别控制未选择的页面指示器和当前选中页面指示器的颜色。

环绕

在 TEQuickPageViewController 的属性中,Wrap Around 特性允许您的页面从末尾 "环绕" 回到开头。

当禁用时,用户将无法从第一页向后滑动,或从最后一页向前滑动。

自定义二次故事板标识符

默认情况下,您的页面二次故事板需要一个 "page" 的标识符,但这可能并不理想。

要指定您自己的标识符,只需在 TEQuickPageViewController 上设置 "二次故事板 Id" 属性。您现在可以更改二次故事板的标识符为此字符串。

已知问题

循环导致崩溃

如果您链中的页面有循环(例如,连接页面 1 -> 页面 2 -> 页面 1),这将导致在建立页面数组时的无限循环,我们的应用程序将崩溃。

如果您的链中存在循环,应该很容易找到,并删除该问题二次故事板。

示例项目

TEQuickPageViewController.xcodeproj 是一个简单的 iOS 应用,该应用利用了 TEQuickPageViewController 类。您可以随时打开它,并对其进行探索!

许可

TEQuickPageViewController 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。