Swiftpack.co - BTAProgrammers/SpreadsheetView as Swift Package

Swiftpack.co is a collection of thousands of indexed Swift packages. Search packages.
See all packages published by BTAProgrammers.
BTAProgrammers/SpreadsheetView 0.9.2
A Excel like spreadsheet view native in iOS Applications. Maintained by Fady Faheem based of bannzai/SpreadsheetView
⭐️ 1
🕓 1 week ago
.package(url: "https://github.com/BTAProgrammers/SpreadsheetView.git", from: "0.9.2")

Build Status Platforms

Full configurable spreadsheet view user interfaces for iOS applications. With this framework, you can easily create complex layouts like schedule, Gantt chart, timetable as if you are using Excel.



  • ☑ Fixed column and row headers
  • ☑ Merge cells
  • ☑ Circular infinite scrolling automatically
  • ☑ Customize gridlines and borders for each cell
  • ☑ Customize inter cell spacing vertically and horizontally
  • ☑ Fast scrolling, memory efficient
  • UICollectionView like API
  • ☑ Well unit tested
Find the above displayed examples in the Examples folder.


SpreadsheetView is written in Swift 5. Compatible with iOS 12.0+



SpreadsheetView is will be available through CocoaPods. However I have not yet pushed it up to it.


For SwiftPM, add the following package by going to File -> Add Packages and using the git link:


Getting Started

The minimum requirement is connecting a data source to return the number of columns/rows, and each column width/row height.

import UIKit
import SpreadsheetView

class ViewController: UIViewController, SpreadsheetViewDataSource {
    @IBOutlet weak var spreadsheetView: SpreadsheetView!

    override func viewDidLoad() {
        spreadsheetView.dataSource = self

    func numberOfColumns(in spreadsheetView: SpreadsheetView) -> Int {
        return 200

    func numberOfRows(in spreadsheetView: SpreadsheetView) -> Int {
        return 400

    func spreadsheetView(_ spreadsheetView: SpreadsheetView, widthForColumn column: Int) -> CGFloat {
      return 80

    func spreadsheetView(_ spreadsheetView: SpreadsheetView, heightForRow row: Int) -> CGFloat {
      return 40


Freeze column and row headers

Freezing a column or row behaves as a fixed column/row header.

Column Header

func frozenColumns(in spreadsheetView: SpreadsheetView) -> Int {
    return 2

Row Header

func frozenRows(in spreadsheetView: SpreadsheetView) -> Int {
    return 2


func frozenColumns(in spreadsheetView: SpreadsheetView) -> Int {
    return 2

func frozenRows(in spreadsheetView: SpreadsheetView) -> Int {
    return 2

Merge cells

Multiple cells can be merged and then they are treated as one cell. It is used for grouping cells.

func mergedCells(in spreadsheetView: SpreadsheetView) -> [CellRange] {
    return [CellRange(from: (row: 1, column: 1), to: (row: 3, column: 2)),
            CellRange(from: (row: 3, column: 3), to: (row: 8, column: 3)),
            CellRange(from: (row: 4, column: 0), to: (row: 7, column: 2)),
            CellRange(from: (row: 2, column: 4), to: (row: 5, column: 8)),
            CellRange(from: (row: 9, column: 0), to: (row: 10, column: 5)),
            CellRange(from: (row: 11, column: 2), to: (row: 12, column: 4))]

Circular Scrolling

Your table acquires infinite scroll just set circularScrolling property.

Enable horizontal circular scrolling

spreadsheetView.circularScrolling = CircularScrolling.Configuration.horizontally

Enable vertical circular scrolling

spreadsheetView.circularScrolling = CircularScrolling.Configuration.vertically


spreadsheetView.circularScrolling = CircularScrolling.Configuration.both

If circular scrolling is enabled, you can set additional parameters that the option not to repeat column/row header and to extend column/row header to the left/top edges. CircularScrolling.Configuration is a builder pattern, can easily select the appropriate combination by chaining properties.


spreadsheetView.circularScrolling = 
spreadsheetView.circularScrolling = 

Customize gridlines, borders and cell spacing

You can customize the appearance of grid lines and borders of the cell. You can specify whether a cell has a grid line or border. Grid lines and borders can be displayed on the left, right, top, or bottom, or around all four sides of the cell.

The difference between gridlines and borders is that the gridlines are drawn at the center of the inter-cell spacing, but the borders are drawn to fit around the cell.

Cell spacing

spreadsheetView.intercellSpacing = CGSize(width: 1, height: 1)


SpreadsheetView's gridStyle property is applied to the entire table.

spreadsheetView.gridStyle = .solid(width: 1, color: .lightGray)

You can set different gridStyle for each cell and each side of the cell. If you set cell's gridStyle property to default, SpreadsheetView's gridStyle property will be applied. Specify none means the grid will not be drawn.

cell.gridlines.top = .solid(width: 1, color: .blue)
cell.gridlines.left = .solid(width: 1, color: .blue)
cell.gridlines.bottom = .none
cell.gridlines.right = .none


You can set different borderStyle for each cell as well.

cell.borders.top = .solid(width: 1, color: .red)
cell.borders.left = .solid(width: 1, color: .red)
cell.borders.bottom = .solid(width: 1, color: .red)
cell.borders.right = .solid(width: 1, color: .red)


Creator - Kishikawa Katsumi, [email protected]

Maintaining - Fady Faheem, [email protected]


SpreadsheetView is available under the MIT license. See the LICENSE file for more info.


Stars: 1
Last commit: 5 days ago
jonrohan Something's broken? Yell at me @ptrpavlik. Praise and feedback (and money) is also welcome.

Release Notes

1 week ago
  • Fixed AnyObject Deprecation from iOS 13 in SpreadsheetViewDelegate & SpreadsheetViewDataSource
  • Fixed UIEdgeSets from iOS 13 Deprecation in SpreadsheetView+UIScrollView replaced with horizontalScrollIndicatorInsets, verticalScrollIndicatorInsets
  • Fixed Deprecation in ViewTests for statusBarFrame being called through UIApplication instead of called from viewController and optional checking.
  • Added swift.yml checking through Xcode

Swiftpack is being maintained by Petr Pavlik | @ptrpavlik | @swiftpackco | API | Analytics