https://github.com/lorenzofiamingo/customswiftui

https://github.com/lorenzofiamingo/customswiftui

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/lorenzofiamingo/customswiftui
• Owner: lorenzofiamingo
• License: mit
• Created: 2023-01-20T16:39:16.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-12T15:18:29.000Z (12 months ago)
• Last Synced: 2024-10-18T19:29:45.939Z (2 months ago)
• Language: Swift
• Size: 327 KB
• Stars: 12
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
[![CocoaPods Release](https://github.com/lorenzofiamingo/customswiftui/actions/workflows/CocoaPods%20Release.yml/badge.svg)](https://github.com/lorenzofiamingo/customswiftui/actions/workflows/CocoaPods%20Release.yml)

# CustomSwiftUI

CustomSwiftUI aims to complement the SwiftUI standard library. 

## When to resort to CustomSwiftUI

CustomSwiftUI should cover those cases:

- A certain SwiftUI API is not public

- A certain SwiftUI API is not available in old OSes

- A certain UIKit API is not available in SwiftUI

## Contents

### View fundamentals

- [x] `CustomView`

: Use `CustomView` replacing `body` with `customBody` if you want the body of the `View` to be exposed to the `CustomViewBuilder`.

- [x] `CustomViewBuilder`

: `CustomViewBuilder` makes possible to inspect the view tree hierarchy (until a `ViewBuilder` is encountered).

- [x] `customTag`

### Lists

- [x] `CustomForEach`

### Controls and indicators

- [x] `CustomPicker`

: `CustomPicker` makes possible to implement picker style via `CustomPickerStyle` and polyfills the creation of picker from a collection.

### Drawing and graphics

- [x] `customTint`

: `customTint` makes possible to set and retrieve a tint color in the environment.

## Design

The purpose of CustomSwiftUI is to extend the SwiftUI library by ensuring the greatest possible consistency with it, so the APIs of the two libraries have to match as much as possible.

### Naming convention

In order to avoid collisions, ensure API discovery, and make clear in code the usage of CustomSwiftUI APIs, all top-level structures and methods in SwiftUI API extensions must begin with `Custom`.

For example, to polyfill `ColorPicker` back to older OSes, `CustomColorPicker` should be created.