大老师语录
“人是不会改变的。若真要改变的话,那只有一种方法。”
“只有反复经历惨痛的遭遇,在内心刻下无法抹去的伤痕,通过伤痛产生的回避本能,条件反射地改变自己的行为。”
QLPreviewController是苹果系统自带的一个可供预览文件的控件,在工程中做邮件附件预览时用到,在这简单总结下用法。
首先要介绍的是QLPreviewItem,可以理解为是QLPreviewController展示的内容item,苹果对其进行了封装,我们看到的是扩充的QLPreviewItem协议。
QLPreviewItem内主要有两个属性,分别是:
@property(readonly, nonnull, nonatomic) NSURL * previewItemURL;
和
@property(readonly, nullable, nonatomic) NSString * previewItemTitle;
值得强调的是,previewItemURL是@required属性,previewItemTitle是@optional,即要展示对应内容的previewItemURL必需有值。
而且官方给previewItemURL的注释是:
* @discussion The URL must be a file URL.
最开始使用的时候给了个非本地文件URL,导致崩溃,这也是个坑需要注意,默认展示的仅能是本地文件路径对应的URL,如果URL对应的文件路径不存在,则展示一个空页面。
回到QLPreviewController,QLPreviewController主要有以下几个属性:
@property NSInteger currentPreviewItemIndex;<span style="font-family: Arial, Helvetica, sans-serif;"> </span>
@property(readonly, nullable) id <QLPreviewItem> currentPreviewItem;
currentPreviewItemIndex对应当前展示内容第几页,currentPreviewItem对应当前展示的QLPreviewItem。
QLPreviewController对应的主要方法有:
- (void)reloadData;
- (void)refreshCurrentPreviewItem;
可以理解为和tableview的reloadData和reloadSection对应,根据数据源刷新展示的内容。
而同样对应的,QLPreviewController也有自己的dataSource和delegate:
@property(weak, nullable) id <QLPreviewControllerDataSource> dataSource;
@property(weak, nullable) id <QLPreviewControllerDelegate> delegate;
dataSource仅有两个方法,而且都是@required:
- (NSInteger)numberOfPreviewItemsInPreviewController:(QLPreviewController *)controller;
- (id <QLPreviewItem>)previewController:(QLPreviewController *)controller previewItemAtIndex:(NSInteger)index;
delegate更多的主要是对controller展示和跳转上的控制,不过多介绍。
使用上个人是将QLPreviewController封装成单例使用,展示内容时传入对应的文件路径和要展示的controller:
- (void)showAttachmentWithPathAndViewController:(NSString *)attachmentPath
viewController:(UIViewController *)viewController {
self.attachmentPath = attachmentPath;
[self.previewController refreshCurrentPreviewItem];
[viewController presentViewController:self.previewController
animated:YES
completion:nil];
}
其中需要注意的是,在展示QLPreviewController之前,需要调reloadData或者refreshCurrentPreviewItem刷新当前数据源,否则因为单例的关系,默认会展示上次的数据源。
以上,总结得并不完全,有问题欢迎指正。