7

所以我需要一些帮助,因为我无法真正弄清楚并且已经花了很多时间没有任何结果。我在互联网上找到的大部分内容都是关于如何将 swift 项目转换为框架,但我的问题不是项目本身或 cocoapods,而是关于我应该如何以及应该让开发人员可以访问的内容。

所以我构建了一个 Swift 框架,你可以在这里找到它,它UICollectionView具有自定义flowlayout和侧滑功能。

问题是我不知道如何让开发人员轻松使用它,我想让它表现得像UICollectionView你需要实现自定义委托和数据源而不必使用默认值UICollectionViewDelegateUICollectionViewDatasource,所以我可以过滤掉会导致意外行为的事情,或者让事情变得简单。

那么这里有什么好的方法呢?我正在考虑可能将其子类化,UICollectionView因此人们不必使用 a UICollectionView(因为这可能会让人感到困惑)而是 aVerticalCardSwiperView具有相同的行为,但更受限制。我只是不知道这是否是正确的方法。

任何提示、见解或好的例子将不胜感激!


编辑 1:我更新了项目,因此它已经具有框架结构,我只需要弄清楚我将如何向开发人员提供对自定义部件的访问权限。

编辑2:我得到了一个答案,但我认为这个问题可能很容易被误解。目标是使其行为和行为像UICollectionView(带有委托,数据源,...),但更加有限,我想知道如果可能的话,我该如何实现这一点。

编辑 3:好的,我已经完成了大部分工作,我将在此处留下 Github 在线链接,以便需要类似内容的人自己查看。本质上,我所做的是定制的VerticalCardSwiperDelegateVerticalCardSwiperDatasource就像这样:

/// This datasource is used for providing data to the `VerticalCardSwiper`.
public protocol VerticalCardSwiperDatasource: class {

    /**
     Sets the number of cards for the `UICollectionView` inside the VerticalCardSwiperController.
     - parameter verticalCardSwiperView: The `VerticalCardSwiperView` where we set the amount of cards.
     - returns: an `Int` with the amount of cards we want to show.
     */
    func numberOfCards(verticalCardSwiperView: VerticalCardSwiperView) -> Int

    /**
     Asks your data source object for the cell that corresponds to the specified item in the `VerticalCardSwiper`.
     Your implementation of this method is responsible for creating, configuring, and returning the appropriate `CardCell` for the given item.
     - parameter verticalCardSwiperView: The `VerticalCardSwiperView` that will display the `CardCell`.
     - parameter index: The that the `CardCell` should be shown at.
     - returns: A CardCell object. The default value is an empty CardCell object.
    */
    func cardForItemAt(verticalCardSwiperView: VerticalCardSwiperView, cardForItemAt index: Int) -> CardCell
}

然后我在VerticalCardSwiper课堂上把它们联系起来:

public func collectionView(_ collectionView: UICollectionView, numberOfItemsInSection section: Int) -> Int {

    return datasource?.numberOfCards(verticalCardSwiperView: verticalCardSwiperView) ?? 0
}

public func collectionView(_ collectionView: UICollectionView, cellForItemAt indexPath: IndexPath) -> UICollectionViewCell {

    return (datasource?.cardForItemAt(verticalCardSwiperView: verticalCardSwiperView, cardForItemAt: indexPath.row))!
}

最后,我刚刚UICollectionView将 a 子类化为 aVerticalCardSwiperView并将其作为参数传递(因为它基本上是 a 的子类,UICollectionView它做同样的事情,只是有一个不同的名称,这对于开发人员来说更容易理解)用于委托/数据源功能。希望这对其他人有帮助。另外,如果您有更好的方法,请告诉我。

4

1 回答 1

3

看起来不错!

我会说,如果您想公开,UICollectionView那么请按照子类代表UITableView的方法进行。UIScrollView

protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
  // ...

您还可以分别子类化UICollectionViewDelegateUICollectionViewDataSourceinVerticalCardSwiperDelegateVerticalCardSwiperDataSource委托,以获得相同的效果。(如果您认为这样做是有意义的。)

protocol VerticalCardSwiperDelegate: UICollectionViewDelegate {
  // ...

也就是说,您的组件非常具体,可能暴露底层 UICollectionView 可能会导致问题。在这里,我将锁定所有的实现细节,并一直进行VerticalCardSwiper下去。这为您提供了完成更改底层架构的灵活性。

例如,在您的委托中,您将回传VerticalCardSwiper而不是底层组件。

func cardForItemAt(verticalCardSwiper: VerticalCardSwiper, cardForItemAt index: Int) -> CardCell {
  // ...

通常,您希望使暴露的接口尽可能小。这是为了帮助指导开发人员(要学习的东西更少),而您需要维护和解决的问题也更少。

对公共接口的一些评论会有所帮助。当我可以 command-alt-click 获得一些提示时,我很高兴。你已经这样做了。

于 2018-05-17T11:05:22.410 回答