Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/swiftui-plus/containers
Useful SwiftUI container view's. FittingGeometry, ScrollableView, LayoutReader, PageView, UIKitView. (iOS)
https://github.com/swiftui-plus/containers
containerview ios swift swiftui
Last synced: about 2 months ago
JSON representation
Useful SwiftUI container view's. FittingGeometry, ScrollableView, LayoutReader, PageView, UIKitView. (iOS)
- Host: GitHub
- URL: https://github.com/swiftui-plus/containers
- Owner: SwiftUI-Plus
- License: mit
- Created: 2021-08-28T20:24:45.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-07-06T21:54:15.000Z (over 2 years ago)
- Last Synced: 2023-03-06T06:37:05.005Z (almost 2 years ago)
- Topics: containerview, ios, swift, swiftui
- Language: Swift
- Homepage: https://benkau.com/packages.json
- Size: 23.4 KB
- Stars: 33
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
----
> Most of these containers now available as in a single Backports library, with a LOT more additions. This should simply my efforts and allow me and others to contribute more backports in the near future.
> [SwiftUI Backports](https://github.com/shaps80/SwiftUIBackports)
----
# Containers
> Also available as a part of my [SwiftUI+ Collection](https://benkau.com/packages.json) – just add it to Xcode 13+
Useful SwiftUI container view's for additional convenience.
Includes:
- FittingGeometryReader (auto-sizes its height)
- ScrollableView (support various contentMode options)
- LayoutReader (supports readable and other other guides)
- PageView (TabView in paging style but supports auto-sizing)
- UIKit View (Easily nest UIView's in SwiftUI, including auto-sizing)
## FittingGeometry
A geometry reader that automatically sizes its height to 'fit' its content.
```swift
FittingGeometryReader { geo in
Text("The height is now \(geo.size.height)")
}
```
## LayoutReader
A container view that provides a layout proxy, allowing you to query various layout properties usually only available via UIKit.
The most useful example is layout-relative to the `readableContentGuide`
**Features**
- Familiar API (similar to GeometryReader)
- SafeArea, content (layoutMargins) and readable content guide layouts
- Responds automatically to dynamic type changes
- Respects interface orientation and other layout changes
```swift
LayoutReader { layout in
Rectangle()
.foregroundColor(.red)
.frame(maxWidth: layout.frame(in: .readable).width)
}
```
## ScrollView
A scrollview that behaves more similarly to a `VStack` when its content size is small enough.
```swift
ScrollView(contentMode: .fit) {
Text("I'm aligned to the top")
Spacer()
Text("I'm aligned to the bottom, until you scroll ;)")
}
```
## PageView
A page view that behaves similarly to UIPageViewController but adds auto-sizing configuration.
```swift
// Passing `fit` for the contentMode forces the PageView to hug its content. To fill the available space, set this to `fill` (its default value)
PageView(selection: $currentPage, contentMode: .fit) {
Group {
Text("Page 1")
Text("Page 2")
Text("Page 3")
}
}
```
> Note: This view requires iOS 14+
## UIKitView
A SwiftUI view that accepts a single UIView instance to be presented in the hierarchy.
```swift
UIKitView {
let label = UILabel(frame: .zero)
label.text = "foo"
return label
}
```
## Installation
The code is packaged as a framework. You can install manually (by copying the files in the `Sources` directory) or using Swift Package Manager (**preferred**)
To install using Swift Package Manager, add this to the `dependencies` section of your `Package.swift` file:
`.package(url: "https://github.com/SwiftUI-Plus/Containers.git", .upToNextMinor(from: "1.0.0"))`
## Other Packages
If you want easy access to this and more packages, add the following collection to your Xcode 13+ configuration:
`https://benkau.com/packages.json`