UIKit框架-高级控件Swift版本: 4.UICollectionView方法/属性详解
前面我们讲解完了iOS的第一个列表控件UITableView以及它的表格空间UITableViewCell, 这次让我们继续来讲解iOS的第二个列表控件UICollectionView.
1.UICollectionView的常用属性
// 1.设置位置和大小
init(frame: CGRect, collectionViewLayout layout: UICollectionViewLayout)
// 2.设置子视图的布局方式
var collectionViewLayout: UICollectionViewLayout
// 3.设置UICollectionView的代理对象
unowned(unsafe) var delegate: UICollectionViewDelegate?
// 4.设置UICollectionView的数据源对象
unowned(unsafe) var dataSource: UICollectionViewDataSource?
// 5.设置UICollectionView的背景视图
var backgroundView: UIView?
// 6.设置 UICollectionView 的 Cell 是否可以点击
var allowsSelection: Bool
// 7.设置 UICollectionView 的 Cell 是否可以多选
var allowsMultipleSelection: BoolUICollectionViewCell显示的样式
struct UICollectionViewScrollPosition : RawOptionSetType {
init(_ rawValue: UInt)
init(rawValue: UInt)
// 1.没有样式
static var None: UICollectionViewScrollPosition { get }
// 2.垂直居中显示
static var CenteredVertically: UICollectionViewScrollPosition { get }
// 3.向下显示
static var Bottom: UICollectionViewScrollPosition { get }
// 4.向左显示
static var Left: UICollectionViewScrollPosition { get }
// 5.水平居中显示
static var CenteredHorizontally: UICollectionViewScrollPosition { get }
// 6.向右显示
static var Right: UICollectionViewScrollPosition { get }
}
2.UICollectionView常用的方法
// 1.设置UICollectionView的注册类, 以及标示符
func registerClass(cellClass: AnyClass?, forCellWithReuseIdentifier identifier: String)
// 2.设置 UICollectionView的注册Nib, 以及标示符
func registerNib(nib: UINib?, forCellWithReuseIdentifier identifier: String)
// 3.设置 UICollectionView 的注册类, 以及辅助视图名称, 标示符
func registerClass(viewClass: AnyClass?, forSupplementaryViewOfKind elementKind: String, withReuseIdentifier identifier: String)
// 4.设置 UICollectionView的注册Nib, 以及辅助视图名称, 标示符
func registerNib(nib: UINib?, forSupplementaryViewOfKind kind: String, withReuseIdentifier identifier: String)
// 5.设置 UICollectionView 可重用的 Cell 以及所以路径
func dequeueReusableCellWithReuseIdentifier(identifier: String, forIndexPath indexPath: NSIndexPath!) -> AnyObject
// 6.设置 UICollectionView 可重用的的辅视图, 标示符, 以及索引路径
func dequeueReusableSupplementaryViewOfKind(elementKind: String, withReuseIdentifier identifier: String, forIndexPath indexPath: NSIndexPath!) -> AnyObject
// 7.选择 Item 的索引路径
func indexPathsForSelectedItems() -> [AnyObject]
// 8.选择 Item 的索引路径, 以及是否使用动画, 显示样式
func selectItemAtIndexPath(indexPath: NSIndexPath?, animated: Bool, scrollPosition: UICollectionViewScrollPosition)
// 9.取消选择 Item 的索引路径, 以及是否使用动画
func deselectItemAtIndexPath(indexPath: NSIndexPath?, animated: Bool)
// 10.刷新数据
func reloadData()
// 11.设置 UICollectionView 的集合视图布局, 及是否使用动画
func setCollectionViewLayout(layout: UICollectionViewLayout, animated: Bool)
// 12.设置 UICollectionView 的集合视图布局, 及是否使用动画, 以及完成之后的闭包方法
func setCollectionViewLayout(layout: UICollectionViewLayout, animated: Bool, completion: ((Bool) -> Void)!)
// 13.设置 UICollectionView 显示多少个 Item
func numberOfSections() -> Int
// 14.设置 UICollectionView 显示多少组 Item
func numberOfItemsInSection(section: Int) -> Int
// 15.设置 UICollectionView 滚动到第几个 Item 的索引路径, 以及显示样式和是否启用动画
func scrollToItemAtIndexPath(indexPath: NSIndexPath, atScrollPosition scrollPosition: UICollectionViewScrollPosition, animated: Bool)
// 16.在 UICollectionView 中插入某个 Item
func insertSections(sections: NSIndexSet)
// 17.在 UICollectionView 中删除某个 Item
func deleteSections(sections: NSIndexSet)
// 16.在 UICollectionView 中刷新某个 Item
func reloadSections(sections: NSIndexSet)
// 17.移动 UICollectionView 中某个 Item 到某个位置
func moveSection(section: Int, toSection newSection: Int)
UICollectionView代理方法
// 1.点击 Item 时调用的方法
optional func collectionView(collectionView: UICollectionView, didSelectItemAtIndexPath indexPath: NSIndexPath)
// 2.取消选中 Item 时调用的方法
optional func collectionView(collectionView: UICollectionView, didDeselectItemAtIndexPath indexPath: NSIndexPath)UICollectionView数据源方法
// 1.设置UICollectionView有多少个Item
func collectionView(collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int
// 2.设置 UICollectionViewCell 所显示的内容, 以及索引路径
func collectionView(collectionView: UICollectionView, cellForItemAtIndexPath indexPath: NSIndexPath) -> UICollectionViewCell
// 3.设置 UICollectionView 有多少组 Cell
optional func numberOfSectionsInCollectionView(collectionView: UICollectionView) -> IntUICollectionView的集视图布局方法
// 1.该方法是用来设置 UICollectionView 的 Item 尺寸大小
optional func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAtIndexPath indexPath: NSIndexPath) -> CGSize
// 2.该方法是用来设置 UICollectionView 的 Item 四周的边界
optional func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAtIndex section: Int) -> UIEdgeInsets
// 3.该方法是用来设置 UICollectionView 的 Item 上下之间的最小间距(如果在自定义UICollectionView中实现了该属性, 那么该方法就会覆盖掉原来的属性)
optional func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumLineSpacingForSectionAtIndex section: Int) -> CGFloat
// 4.该方法是用来设置 UICollectionView 的 Item 左右之间的最小间距(如果在自定义UICollectionView中实现了该属性, 那么该方法就会覆盖掉原来的属性)
optional func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumInteritemSpacingForSectionAtIndex section: Int) -> CGFloat
// 5.该方法是用来设置 UICollectionView 的页头尺寸(如果在自定义UICollectionView中实现了该属性, 那么该方法就会覆盖掉原来的属性)
optional func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForHeaderInSection section: Int) -> CGSize
// 6.该方法是用来设置 UIcollectionView 的页尾尺寸(如果在自定义UICollectionView中实现了该属性, 那么该方法就会覆盖掉原来的属性)
optional func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForFooterInSection section: Int) -> CGSize
3.代码演示
首先我们要遵守以下协议
class ViewController: UIViewController, UICollectionViewDataSource, UICollectionViewDelegate, UICollectionViewDelegateFlowLayout {
}自定义UICollectionView
func myCollectionView() {
// 1.自定义 Item 的FlowLayout
let flowLayout = UICollectionViewFlowLayout()
// 2.设置 Item 的 Size
flowLayout.itemSize = CGSizeMake(90, 120)
// 3.设置 Item 的排列方式
flowLayout.scrollDirection = UICollectionViewScrollDirection.Vertical
// 4.设置 Item 的四周边距
flowLayout.sectionInset = UIEdgeInsetsMake(20, 20, 20, 20)
// 5.设置同一竖中上下相邻的两个 Item 之间的间距
flowLayout.minimumLineSpacing = 20
// 6.设置同一行中相邻的两个 Item 之间的间距
flowLayout.minimumInteritemSpacing = 20
// 7.设置UICollectionView 的页头尺寸
flowLayout.headerReferenceSize = CGSizeMake(100, 50)
// 8.设置 UICollectionView 的页尾尺寸
flowLayout.footerReferenceSize = CGSizeMake(100, 50)
// 1.自定义 UICollectionView 的位置大小, 以及 Item 的显示样式为 flowLayout
var collection = UICollectionView(frame: CGRectMake(0, 64, self.view.frame.width, self.view.frame.height - 64), collectionViewLayout: flowLayout)
// 2.设置 UICollectionView 的背景颜色
collection.backgroundColor = UIColor.whiteColor()
// 3.设置 UICollectionView 垂直滚动是否滚到 Item 的最底部内容
collection.alwaysBounceVertical = true
// 4.设置 UICollectionView 垂直滚动是否滚到 Item 的最右边内容
collection.alwaysBounceHorizontal = true
// 5.设置 UICollectionView 的数据源对象
collection.dataSource = self
// 6.设置 UICollectionView 的代理对象
collection.delegate = self
// 7.设置 UICollectionView 的单元格点击(默认是 true)
collection.allowsSelection = true
// 8.设置 UICollectionView 的单元格多选(默认是 false)
collection.allowsMultipleSelection = false
// 9.开启 UICollectionView 的分页显示效果
collection.pagingEnabled = true
// 10.注册 UICollectionViewCell
collection.registerClass(UICollectionViewCell.self, forCellWithReuseIdentifier: "cell")
// 11.添加到 self.view 上
self.view.addSubview(collection)
}自定义UINavigationBar
func myNavigationBar() {
// 1.自定义 NavigationBar, 设置它的位置大小
var navigationBar = UINavigationBar(frame: CGRectMake(0, 0, self.view.frame.width, 64))
// 2.设置 NavigationBar 的背景色
navigationBar.backgroundColor = UIColor.redColor()
// 3.自定义 NavigationItem 设定它的 Title
let navigationItem = UINavigationItem(title: "UICollectionView演示")
// 4.自定义 UIBarButtonItem 的Title, Style, Target 的对象, 已经监听的方法
let leftButton = UIBarButtonItem(title: "返回", style: UIBarButtonItemStyle.Plain, target: self, action: "back")
// 5.设置 Navigation 左边的按钮为 leftButton
navigationItem.leftBarButtonItem = leftButton
// 6.把 NavigationItem 添加到 NavigationBar
navigationBar.pushNavigationItem(navigationItem, animated: true)
// 7.添加到到 self.view 上
self.view.addSubview(navigationBar)
}
// 8.NavigationBar监听方法
func back() {
println("点击了返回")
}UICollectionView的代理方法, 数据源方法, FlowLayout 方法
// 1.该方法是用来设置返回 CollectionViewCell 的组数
func numberOfSectionsInCollectionView(collectionView: UICollectionView) -> Int {
return 1
}
// 2.该方法是用来设置返回 CollectionViewCell 的个数
func collectionView(collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {
return 15
}
// 3.该方法是用来设置 CollectionViewCell 的内容
func collectionView(collectionView: UICollectionView, cellForItemAtIndexPath indexPath: NSIndexPath) -> UICollectionViewCell {
var collectionCell = collectionView.dequeueReusableCellWithReuseIdentifier("cell", forIndexPath: indexPath) as! UICollectionViewCell
collectionCell.backgroundColor = UIColor.redColor()
return collectionCell
}
// 4.该方法是点击了 CollectionViewCell 时调用的监听方法
func collectionView(collectionView: UICollectionView, didSelectItemAtIndexPath indexPath: NSIndexPath) {
println("aaa")
}
// 5.该方法是用来设置 CollectionViewCell 的大小
func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, sizeForItemAtIndexPath indexPath: NSIndexPath) -> CGSize {
return CGSizeMake(90, 120)
}
// 6.该方法是用来设置 CollectionViewCell 四周的边距
func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, insetForSectionAtIndex section: Int) -> UIEdgeInsets {
return UIEdgeInsetsMake(20, 20, 20, 20)
}
// 7.该方法是用来设置同一行 CollectionViewCell 之间的间距
func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumInteritemSpacingForSectionAtIndex section: Int) -> CGFloat {
return 20
}
// 8.该方法是用来设置同一列 CollectionViewCell 之间的间距
func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, minimumLineSpacingForSectionAtIndex section: Int) -> CGFloat {
return 20
}
// 9.该方法是用来设置 CollectionView 的页头尺寸
func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForHeaderInSection section: Int) -> CGSize {
return CGSizeMake(100, 50)
}
// 10.该方法是用来设置 CollectionView 的页尾尺寸
func collectionView(collectionView: UICollectionView, layout collectionViewLayout: UICollectionViewLayout, referenceSizeForFooterInSection section: Int) -> CGSize {
return CGSizeMake(100, 50)
}4.最终效果
PS: UIColleCtionView 是继承于 UIScrollView 的, 所以 UIScrollView 里的属性, 以及方法都是可以用的.
好了这次我们就讲到这里, 下次我们继续~~
