https://github.com/admkopec/sidebartableview

📱iPadOS 14 Sidebar implemented as UITableView with support for iOS 11.0+
https://github.com/admkopec/sidebartableview

ios ipad ipados sidebar uitableview uitableviewcontroller

Last synced: 12 months ago
JSON representation

📱iPadOS 14 Sidebar implemented as UITableView with support for iOS 11.0+

• Host: GitHub
• URL: https://github.com/admkopec/sidebartableview
• Owner: admkopec
• License: mit
• Created: 2021-06-28T16:51:38.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2021-09-15T15:58:23.000Z (over 4 years ago)
• Last Synced: 2025-01-05T16:13:01.826Z (about 1 year ago)
• Topics: ios, ipad, ipados, sidebar, uitableview, uitableviewcontroller
• Language: Swift
• Homepage:
• Size: 87.9 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# SidebarTableView

![Platforms](https://img.shields.io/badge/platform-ios-lightgrey)

[![GitHub](https://img.shields.io/badge/license-MIT-green)](LICENSE)

[![Swift Package Manager](https://img.shields.io/badge/package%20manager-compatible-brightgreen.svg?logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB3aWR0aD0iNjJweCIgaGVpZ2h0PSI0OXB4IiB2aWV3Qm94PSIwIDAgNjIgNDkiIHZlcnNpb249IjEuMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayI+CiAgICA8IS0tIEdlbmVyYXRvcjogU2tldGNoIDYzLjEgKDkyNDUyKSAtIGh0dHBzOi8vc2tldGNoLmNvbSAtLT4KICAgIDx0aXRsZT5Hcm91cDwvdGl0bGU+CiAgICA8ZGVzYz5DcmVhdGVkIHdpdGggU2tldGNoLjwvZGVzYz4KICAgIDxnIGlkPSJQYWdlLTEiIHN0cm9rZT0ibm9uZSIgc3Ryb2tlLXdpZHRoPSIxIiBmaWxsPSJub25lIiBmaWxsLXJ1bGU9ImV2ZW5vZGQiPgogICAgICAgIDxnIGlkPSJHcm91cCIgZmlsbC1ydWxlPSJub256ZXJvIj4KICAgICAgICAgICAgPHBvbHlnb24gaWQ9IlBhdGgiIGZpbGw9IiNEQkI1NTEiIHBvaW50cz0iNTEuMzEwMzQ0OCAwIDEwLjY4OTY1NTIgMCAwIDEzLjUxNzI0MTQgMCA0OSA2MiA0OSA2MiAxMy41MTcyNDE0Ij48L3BvbHlnb24+CiAgICAgICAgICAgIDxwb2x5Z29uIGlkPSJQYXRoIiBmaWxsPSIjRjdFM0FGIiBwb2ludHM9IjI3IDI1IDMxIDI1IDM1IDI1IDM3IDI1IDM3IDE0IDI1IDE0IDI1IDI1Ij48L3BvbHlnb24+CiAgICAgICAgICAgIDxwb2x5Z29uIGlkPSJQYXRoIiBmaWxsPSIjRUZDNzVFIiBwb2ludHM9IjEwLjY4OTY1NTIgMCAwIDE0IDYyIDE0IDUxLjMxMDM0NDggMCI+PC9wb2x5Z29uPgogICAgICAgICAgICA8cG9seWdvbiBpZD0iUmVjdGFuZ2xlIiBmaWxsPSIjRjdFM0FGIiBwb2ludHM9IjI3IDAgMzUgMCAzNyAxNCAyNSAxNCI+PC9wb2x5Z29uPgogICAgICAgIDwvZz4KICAgIDwvZz4KPC9zdmc+)](https://github.com/apple/swift-package-manager)

[![swift-version](https://img.shields.io/badge/swift-5-brightgreen.svg)](https://github.com/apple/swift)

This framework is an _UITableView_ implementation of the __iPadOS 14 Sidebar__. It works on older iOS versions and provides easy fallbacks for the compact view controller on iOS versions before iOS 14, which added the __compact view controller__ option to the _UISplitViewController_. This framework can also automatically adjust the style of the sidebar to match iOS 14 and iOS 15 look.



## 💻 Requirements

This framework works on iPhones and iPads with the minimum system requirements:

  * 📱 iOS 11.0+

  

## ⚙️ Supports:

  * __Dark mode__

  * __SF Symbols__

  * __iOS 11.0+__

  * Row Highlighting

  * Multiple Table Sections

  * Compact View Controller fallback on iOS 11 through iOS 13

  

## 🏗 TO-DO:

  - [ ] Fix Navigation Bar's background color on iOS 13 before segue selection

  - [ ] Fix inner cell layout margins after rotation on iOS 11-12

  - [x] Fix navigation bar background and distance to first cell on iOS 11-12

  - [ ] Fix cell image highlight tint when selected on minimal styling

  

## 📖 Usage

To use this framework you can either setup the master detail project in Xcode using the storyboard or by creating each view manually. Remember however to inherit not from _UITableViewController_ but from _SidebarTableViewController_ which is provided by this framework. If you wish to use the compact view controller fallback on iOS versions prior to iOS 14, you should also replace the default _UISplitViewController_ with our custom _AdaptableSplitViewController_ in the storyboard.

## ⚖️ License

SidebarTableView is distributed under the [MIT license](LICENSE).