https://github.com/shaps80/columnview
A column-view navigation controller that behaves similarly to Files and Finder
https://github.com/shaps80/columnview
Last synced: about 1 year ago
JSON representation
A column-view navigation controller that behaves similarly to Files and Finder
- Host: GitHub
- URL: https://github.com/shaps80/columnview
- Owner: shaps80
- Created: 2019-07-01T18:00:54.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-11-19T16:32:25.000Z (over 6 years ago)
- Last Synced: 2024-10-11T13:12:16.596Z (over 1 year ago)
- Language: Swift
- Homepage:
- Size: 1.64 MB
- Stars: 21
- Watchers: 4
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Column View
This framework contains a Files-inspired implementation of a 'Column View' layout. Also similar to what's found in Finder on macOS.
This repo contains 2 main class types:
- `ColumnViewNavigationController`
> For an out-of-the-box solution, simply update your navigation controller class to be this type. This automatically manages your navigation controler to ensure your app behaves as expected based on the current size class.
- `ColumnViewController`
> For a custom solution with no dependencies on navigation controller, you can use the column view directly, provides a horizontally stacked controller implementation. This is useful for example when you want to embed a navigation controller into each column.
Download the repo and run the sample project to see it in action.
---
Finally wherever you're calling `pushViewController` just update it to call:
```swift
// This will replace all controllers after the specified controller as expected
pushViewController(:after:animated:)
```
## Features
For a relatively simple solution, plenty of features are included nonetheless:
All new features
- Right-to-Left support
- Column live-resizing
- Configurable overscroll
Familiar API
- `pushViewController`
- `popViewController`
- `popToViewController`
- `popToRootViewController`
Customizations
- Column width (per view)
- Custom separator (per view)
- Separator thickness
- Separator color
Modern API
- Dark mode support (iOS 13)
- Catalyst support (Xcode 11)
- Size class support, automatically switches between navigation controller and horizontal layout
- Automatically updates navigationBar title and items
- Automatically updates toolbar items
- State restoration support
## Installation
The project is only 2 files so simple download the repo and copy those files into your project:
1. `ColumnsController`
2. `ColumnsViewController`
## Usage
Using the framework is extremely simple. Update your navigation controller class to be: `ColumnsController` and you're done.