Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/diniska/swiftui-system-colors
Use standard system colors from SwiftUI on iOS, macOS or tvOS
https://github.com/diniska/swiftui-system-colors
Last synced: 3 months ago
JSON representation
Use standard system colors from SwiftUI on iOS, macOS or tvOS
- Host: GitHub
- URL: https://github.com/diniska/swiftui-system-colors
- Owner: diniska
- License: mit
- Created: 2020-11-14T07:42:07.000Z (over 4 years ago)
- Default Branch: void
- Last Pushed: 2022-04-26T15:15:33.000Z (almost 3 years ago)
- Last Synced: 2024-04-14T12:39:15.417Z (10 months ago)
- Language: Swift
- Size: 22.5 KB
- Stars: 45
- Watchers: 1
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SwiftUI System Colors
     
Use standard **system colors** from **SwiftUI** on iOS, macOS or tvOS.
Currently, SwiftUI doesn't provide access to standard system colors, so you can find some sort of color conversion (`Color(UIColor.label)`) in almost any SwiftUI project. This library focusing on bringing all the system colors to SwiftUI so you no longer need to write the conversion manually every time.
Benefits of using `SystemColors` package dependency in your project compared to custom implementation or copy-pasting:
* Receive **updates** soon after a system new color is introduced,
* Standardised **naming** for iOS and macOS so that it is always `Color.label` instead of iOS's `UIColor.label` and macOS's `NSColor.labelColor`
* All the **compatibility** checks like `@available(iOS 13.0, *)` or `#if canImport(UIKit)` are implemented by the package and maintained by the community - less chance to introduce an error in one of the platforms support.## How to use
### Step 1
Add a dependency using Swift Package Manager to your project: [https://github.com/diniska/swiftui-system-colors](https://github.com/diniska/swiftui-system-colors)
### Step 2
Import the dependency
```swift
import SystemColors
```### Step 3
Use system colors from SwiftUI the same way you do with `UIColor` or `NSColor`:
```swift
Rectangle()
.background(Color.label)
```## Contribution
Please, open a pull request or an issue if you find that one or the other color is missing or represented in a wrong way.
Please, only add system colors to this package. We only provide convenient interfaces without making a decision about how some colors should look.
For example, if there is no color `systemFill` provided by macOS - we don't provide it on macOS either, but for iOS, it exists and we provide that color on iOS.If you have ideas of how to better test the provided bridging code - please add an issue with the description of your idea or add a pull request with the implementation.
Please, keep the similar code style if you propose a change to the package. Current code style has the next benefits:
* Easy to edit with multiple cursors
* Easy to add new colors with documentation by copying the documentation from Xcode and using multiple cursors
* Providing relevant links to the parts of the standard documentation.