测试已测试 | ✗ |
语言语言 | Obj-CObjective C |
许可证 | Apache 2 |
发布上次发布 | 2016 年 8 月 |
由 Matt Magoffin、Matt Magoffin 和 wmjesstaylor 维护。
内存友好的 iOS 水平滚动视图。
BRScroller 提供了一个 UIScrollView
子类,它有效地管理水平滚动的内容页面,就像 UITableView
管理垂直滚动的行内容一样。此外,BRScroller 为高效显示高分辨率内容(如照片)提供了一些框架。在这方面,BRScroller 可以像 MWPhotoBrowser、TTPhotoViewController 或 EGOPhotoViewer 一样使用。然而,BRScroller 的不同之处在于它不提供任何内置 UI。而不是强制执行任何特定 UI,您可以构建任何适合您应用程序的 UI,并依赖 BRScroller 来执行低级(我敢说,无聊的)工作,帮助您高效地管理内存。
BRScroller 之外无其他依赖项。它支持部署到任何 iOS 设备,版本 5.1 或更高。
请参阅包含在此项目中的 BRScrollerDemo 项目,该项目演示了使用 BRScroller 的不同方法。以下是该项目中可用的演示的描述:
SimpleViewController
一个非常简单的 BRScrollerView
演示,展示了如何处理管理页面视图的基本原则。如果您曾经编写过 UITableViewController
,应该会觉得非常熟悉。
AsyncPhotoViewController
一个演示,展示了常见场景:以类似 iOS 内置的照片应用程序的方式显示图像。在照片之间滚动时显示较小的 预览 图像。当您对任何特定照片进行捏合缩放时,将显示该照片的完整分辨率版本。
PdfViewController
一个演示,展示了使用 BRCachedPreviewPdfPageZoomView
来显示 PDF 文件中的页面。使用 BRScrollerView
在所有 PDF 页面之间滚动,每个页面都在自己的可缩放的滚动视图中展示。显示较小的 预览 图像以快速显示,同时使用 CATiledLayer
绘制 PDF 内容,这使 PDF 内容在缩放时保持清晰。
DemoTiledViewController
演示了使用背靠 CATiledLayer
的视图来渲染任意大小的内容。
MultiViewController
展示了如何一起使用多个滚轮,其中全屏滚轮代表内容的全详情页面,而小型丝带滚轮代表对应于全详情页面的缩略图。点击缩略图会导致全详情页面以动画方式进入视图。
InfiniteViewController
BRScroller具有无限模式,其中页面的数量不一定事先知道(或者有很多页面!)这种模式通过定义一个起点页面,所有其他页面都与该起点相关(例如,-1表示立即左边或1表示立即右边)。
ReverseViewController
BRScroller具有反向布局模式,其中页面以从右到左的顺序定位,而不是默认的从左到右的顺序。
您可以通过CocoaPods或手动作为依赖项目或静态框架来集成BRScroller。
您可以通过几种方式将BRScroller集成到项目中。首先,BRScroller Xcode项目包含一个名为BRScroller.framework的目标,该目标构建一个静态库框架。构建该目标,它将在根项目目录中生成一个BRScroller.framework
捆绑包。将该框架复制到您的项目中,并将其添加为构建依赖项。
您还必须添加以下链接器构建依赖项,可以通过在项目设置的“构建阶段”选项卡中点击“链接二进制与库”部分的+按钮来实现。
QuartzCore.framework
接下来,将-ObjC
添加为其他链接器标志构建设置。
最后,您需要将包含BRScroller.framework
捆绑包的目录路径添加为项目设置的“构建设置”选项卡中的“框架搜索路径”值。
另一种将BRScroller集成到项目中的方法是将BRScroller Xcode项目添加为您的项目的依赖项目。BRScroller Xcode项目包含一个名为BRScroller的目标,该目标构建一个静态库。您可以在自己的项目中使用该目标作为依赖项。《BRScrollerDemo》项目就是这样设置的。
为此,将BRScroller.xcodeproj拖到项目导航器中的您的项目上。然后转到您的项目设置的“构建阶段”选项卡。展开“目标依赖项”部分,并点击+按钮。您应该看到一个可用的选项BRScroller
静态库目标。选择它并点击添加按钮。
您还必须添加以下链接器构建依赖项,可以通过在项目设置的“构建阶段”选项卡中点击“链接二进制与库”部分的+按钮来实现。
QuartzCore.framework
接下来,将-ObjC
添加为其他链接器标志构建设置。
最后,您需要将包含BRScroller.xcodeproj文件的目录路径添加为项目设置的“构建设置”选项卡中的“头文件搜索路径”值。如果您已将BRScroller作为git子模块添加到自己的项目中,则路径可能如下所示:"$(PROJECT_DIR)/../BRScroller"
。