MacOS学习(七) NSCollectionView基本使用

在AppKit中的NSCollectionView与UIKit中的UICollectionView有着很多异同点。他们都能够使用代理和数据源方法来构建其中的每个Cell/Item。但是对于要求简单的需求，AppKit提供了不使用代理就可以实现的简单方法。

我们先来看看通过代理方法实现的NSCollectionView，下面是一个纯代码实现的NSCollectionView

// CKCollectionView.swift

class CKCollectionView: NSView {    // 这里自定义了一个View用来当做容器
    lazy var scrollView: NSScrollView = NSScrollView.init(frame: bounds)
    lazy var collectionView: NSCollectionView = {   // 这里就是我们的NSCollectionView
      // 这里和UICollectionView中的设计一样，我们需要设定布局                                                                                               
        let flowLayout = NSCollectionViewFlowLayout.init()
        flowLayout.scrollDirection = .vertical  // 设置排列方式
        let collection = NSCollectionView.init()
        collection.collectionViewLayout = flowLayout    // 指定布局
        collection.isSelectable = true                  // item是否可以点击
        collection.register(CKCollectionViewItem.self, forItemWithIdentifier: CKCollectionViewItem.identifier)  // 注册Item 和NSCollectionView类似
        return collection
    }()
    override init(frame frameRect: NSRect) {
        super.init(frame: frameRect)
        
        setupSubviews()
    }
    
    required init?(coder decoder: NSCoder) {
        super.init(coder: decoder)
        
        setupSubviews()
    }
    
    func setupSubviews() -> Void {
      // 设置代理
        collectionView.delegate = self
        collectionView.dataSource = self
    /**
      这里需要注意！！！
        scrollView是必要的，collectionView必须属于scrollView的子控件。否则
      func collectionView(_ collectionView: NSCollectionView, itemForRepresentedObjectAt indexPath: IndexPath) -> NSCollectionViewItem
      这个方法不会执行！
      而之所以NSClipView使用再包一层是为了和IB中的层级保持一致，这里具体功效我暂时不是很清楚，目前强行加上
      */
        let clipView = NSClipView.init(frame: bounds)
        clipView.documentView = collectionView;
        scrollView.contentView = clipView;
        addSubview(scrollView)
    
        setupSubviewsConstraints()  // 添加约束
    }
    
    func setupSubviewsConstraints() -> Void {
        NSLayoutConstraint.activate([
            scrollView.topAnchor.constraint(equalTo: (scrollView.superview?.topAnchor)!),
            scrollView.leftAnchor.constraint(equalTo: (scrollView.superview?.leftAnchor)!),
            scrollView.rightAnchor.constraint(equalTo: (scrollView.superview?.rightAnchor)!),
            scrollView.bottomAnchor.constraint(equalTo: (scrollView.superview?.bottomAnchor)!),
            ])
        scrollView.needsLayout = true
      // 使用约束的话 下面这句话是必须有的 否则会影响window，导致window不能用鼠标改变大小
        scrollView.translatesAutoresizingMaskIntoConstraints = false
    }
    
}

extension CKCollectionView: NSCollectionViewDataSource, NSCollectionViewDelegate {
  // 返回Item个数
    func collectionView(_ collectionView: NSCollectionView, numberOfItemsInSection section: Int) -> Int {
        return 100
    }
    /**
    返回我们的Item。这里有一个注意点：
    NSCollectionViewItem是继承自NSViewController。而在NSViewController的初始化方法中，默认回去寻找同名的IB，和UIViewController不同的是，在没有IB的时候，我们直接使用NSViewController.init()是不会有任何问题的，因为loadView方法中会为我们创建默认的view。但是NSViewController则不会，如果我们不手动实现loadView方法自己设置view的话，view不会被创建。所以如果如果遇到控制台说nib找不到的时候，可以重点看看是不是哪个控制器的view没有赋值。
    */
  
    func collectionView(_ collectionView: NSCollectionView, itemForRepresentedObjectAt indexPath: IndexPath) -> NSCollectionViewItem {
        let item = collectionView.makeItem(withIdentifier: CKCollectionViewItem.identifier, for: indexPath)
        return item
    }
    // 点击方法
    func collectionView(_ collectionView: NSCollectionView, didSelectItemsAt indexPaths: Set) {
        print("items select")
    }
}
// NSCollectionView的布局方法
extension CKCollectionView: NSCollectionViewDelegateFlowLayout {
  // 返回Item的size
    func collectionView(_ collectionView: NSCollectionView, layout collectionViewLayout: NSCollectionViewLayout, sizeForItemAt indexPath: IndexPath) -> NSSize {
        return NSSize.init(width: 80, height: 80)   
    }
}