The Swift Package Index logo.Swift Package Index

跟踪 Swift 6 严格并发检查的数据竞争安全性采用情况。有多少 package 为 Swift 6 做好准备?

SwiftTableViewGroup

josercc/SwiftTableViewGroup

使用 Xcode 项目时

使用 Swift Package Manager 清单时

选择一个 package 版本

2.0.1

master


SwiftTableViewGroup 是符合 SwiftUI 设计的 UITableView 和 UICollectionView 数据驱动(SwiftTableViewGroup is a UITableView and UICollectionView data driver compliant with SwiftUI design)




typora-copy-images-to typora-root-url
../SwiftTableViewGroup/images/
../SwiftTableViewGroup

SwiftTableViewGroup

❇️SwiftTableViewGroup 使用最新的 Swift5.1 语法 @_functionBuilder 结合最新的 SwiftUI 设计模式开发。

❇️SwiftTableViewGroup是利用最新的Swift.1语法@_functionBuilder符合SwiftUI设计的数据驱动。

[TOC]

代码示例

Snipaste_2019-07-29_14-11-01

Snipaste_2019-07-29_14-13-30

Snipaste_2019-07-29_14-18-03

Snipaste_2019-07-29_14-19-23

ChangeLog (更新记录)

v2.0.0

  • 支持 UICollectionView 数据驱动
  • 更改 Api 使用更简单
  • 支持自定义高度或者大小
  • 使用更加安全

安装

Swift Package Manager (Xcode 11)

https://github.com/josercc/SwiftTableViewGroup

CocoaPods

pod 'SwiftTableViewGroup'

Carthage

github "josercc/SwiftTableViewGroup"

要求

  • Xcode 11
  • Swift 5.1

如何使用

UITableView

伪代码

let tableView = UITableView()
var dataSource = TableView(tableView:tableView)
/// setup configuration(初始化配置)
dataSource.setup {
  /// Add Header
  TableViewHeaderFooterView
  /// Add Cell
  TableViewCell
  /// Add More Cell
  ...
  /// Add Footer
  TableViewHeaderFooterView
}
/// Perform registration and refresh(执行注册和刷新)
dataSource.reloadData

创建一个简单的列表

TableCell { content, contentCell in
    /// Create a configured block(创建配置的 Block)
    content.configuration(UITableViewCell.self) { (cell, index) in
        cell.textLabel?.text = self.source[index]
        cell.accessoryType = .disclosureIndicator
    }
    /// Create a clickback call block(创建点击回调 Block)
    content.didSelectRow(UITableViewCell.self) { (cell, index) in
    }
}
.number(self.source.count)
.height(45)
}
self.dataSource.reloadData()

image-20190726143607274

创建复杂的表格

let settingDataSource = TableView(tableView: tableView)
settingDataSource.setup {
  	/// Create `SettingHeaderView` Header(创建自定义`SettingHeaderView`Header)
    TableHeaderView(SettingHeaderView.self, { content,contentHeader in
        content.configuration(SettingHeaderView.self) { (view, section) in
            view.textLabel?.text = "Header"
        }
    })
    .height(49)
		/// Create `IntrinsicContentTextLabelCell` Cell(创建`IntrinsicContentTextLabelCell`Cell)
    TableCell(IntrinsicContentTextLabelCell.self)
  	/// Create Dynamic change number Cell(创建动态更改数量的 Cell)
    TableCell { content,contentCell in
        content.configuration(UITableViewCell.self) { (cell, index) in
            cell.textLabel?.text = "\(index) 点击我会增加哦"
        }
        content.didSelectRow(UITableViewCell.self) { (cell, index) in
            let number = contentCell.number + 1;
            contentCell.number(number)
            settingDataSource.reloadData()
        }
    }
    .height(44)
  	/// Create Dynamic change height Cell)(创建动态更改高度的 Cell)
    TableCell { content,contentCell in
        content.configuration(UITableViewCell.self) { (cell, index) in
            cell.textLabel?.text = "点击我改变高度"
        }
        content.didSelectRow(UITableViewCell.self) { (cell, index) in
            let height = contentCell.height == 44 ? 100 : 44;
            contentCell.height(CGFloat(height))
            settingDataSource.reloadData()
        }
    }
    .height(44)
}

image-20190726143714253

动态更改数量

image-20190726145544399

动态修改高度

image-20190726145605726

UICollectionView

self.dataSource.setup {
  	/// Create normal class `UICollectionViewCell` cell(创建默认为`UITableViewCell`类的 Cell)
    CollectionCell { content, cellContent in
        content.configuration(UICollectionViewCell.self) { (cell, index) in
            cell.backgroundColor = index % 2 == 0 ? UIColor.red : UIColor.blue
        }
        content.didSelectRow(UICollectionViewCell.self) { (cell, index) in
            cell.backgroundColor = cell.backgroundColor == UIColor.red ? UIColor.blue : 		UIColor.red
        }
    }
    .number(20)
    .size(CGSize(width: 100, height: 200))

}
.inset(UIEdgeInsets(top: 20, left: 10, bottom: 20, right: 10))
self.dataSource.reloadData()

image-20190729105419637

问题

❓如何动态的插入或者删除一组元素

您可以更改 TableView 的 Sections 数组的另一侧的元素属性,然后调用 reloadData

❓如何监听 UIScrollView 其他代理方法

public struct ScrollViewDelegate {
    public var scrollViewDidScroll:((_ scrollView: UIScrollView) -> Void)?
    public var scrollViewWillBeginDragging:((_ scrollView: UIScrollView) -> Void)?
    public var scrollViewWillEndDragging:((_ scrollView: UIScrollView, _ velocity: CGPoint, _ targetContentOffset: UnsafeMutablePointer<CGPoint>) -> Void)?
    public var scrollViewDidEndDragging:((_ scrollView: UIScrollView, _ decelerate: Bool) -> Void)?
    public var scrollViewWillBeginDecelerating:((_ scrollView: UIScrollView) -> Void)?
    public var  scrollViewDidEndDecelerating:((_ scrollView: UIScrollView) -> Void)?
}

可以实现 UITableView 的上述代理方法

示例

tableView.scrollDelegate?.scrollViewDidScroll = { scrollView in
}

我觉得支持的功能太少了。

可以提交 PR 或提 ISSUSE

Api 文档

  • 高度或者大小的设置优先级
    • 高度 ( UITableViewCell/UITableHeaderFooterView )
      • 自定义 > 设置 > 自动获取 (sizeToFit)
    • 大小 (UICollectionViewCell/UICollectionReusableView)
      • 自定义 > 设置 > FlowLayout

联系我