Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/devpolant/nativeui
iOS library that includes customizable replacements for native UIKit components
https://github.com/devpolant/nativeui
alert customization ios ios-alert native-alert nativeui swift uialertcontroller uikit
Last synced: about 7 hours ago
JSON representation
iOS library that includes customizable replacements for native UIKit components
- Host: GitHub
- URL: https://github.com/devpolant/nativeui
- Owner: devpolant
- License: mit
- Created: 2020-04-05T11:55:42.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-04-10T10:05:35.000Z (over 1 year ago)
- Last Synced: 2024-10-31T16:07:19.546Z (7 days ago)
- Topics: alert, customization, ios, ios-alert, native-alert, nativeui, swift, uialertcontroller, uikit
- Language: Swift
- Homepage:
- Size: 2.01 MB
- Stars: 9
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://swift.org)
[](https://developer.apple.com/xcode)
[](https://cocoapods.org/pods/NativeUI)
[](https://opensource.org/licenses/MIT)
# NativeUI
## Minimum Requirements:
- iOS 11.0
- Xcode 14.0
- Swift 5
## Installation
### Swift Package Manager
```swift
dependencies: [
.package(url: "https://github.com/devpolant/NativeUI.git", .upToNextMajor(from: "1.2.2"))
]
```
#### CocoaPods
```ruby
target 'MyApp' do
pod 'NativeUI', '~> 1.2.2'
end
```
If you don't need to connect all UI components you may use subspecs like:
```ruby
target 'MyApp' do
pod 'NativeUI/Alert', '~> 1.2.2'
end
```
Available subspecs:
- `Utils`
- `Alert`
## Alert
**`AlertViewController` is a customizable replacement for native `UIAlertController`.**
Sometimes we need to set NSAttributedString into native alert, but public API doesn't allow it. As a workaroud we could use private API, but in general we should avoid using it.
`AlertViewController` looks exactly like native `UIAlertController`, but very configurable.
### Configuration
1. Default initialization with title, message as `String`.
```swift
let cancelAction = Alert.Action(title: "Cancel", style: .primary)
let confirmAction = Alert.Action(title: "Confirm", style: .default)
let viewModel = Alert(
title: "Your Title",
titleFont: ... // your custom title font
message: "Your Message",
messageFont: ... // your custom message font
actions: [cancelAction, confirmAction]
)
let alert = AlertViewController(viewModel: viewModel)
present(alert, animated: true)
```
2. Default initialization with title, message as `NSAttributedString`
```swift
let cancelAction = Alert.Action(title: "Cancel", style: .primary)
let confirmAction = Alert.Action(title: "Confirm", style: .default)
let viewModel = Alert(
title: ... // your title (NSAttributedString)
message: ... // your message (NSAttributedString)
actions: [cancelAction, confirmAction]
)
let alert = AlertViewController(viewModel: viewModel)
present(alert, animated: true)
```
3. Initialization with title, message and custom `UIView` object as content view to implement complex layout.
```swift
let cancelAction = Alert.Action(title: "Cancel", style: .primary)
let confirmAction = Alert.Action(title: "Confirm", style: .default)
let customView = CustomView()
customView.translatesAutoresizingMaskIntoConstraints = false
customView.imageView.backgroundColor = .orange
customView.titleLabel.text = "Some text"
customView.subtitleLabel.text = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."
let viewModel = Alert(
title: "Your Title",
message: nil,
contentView: customView,
actions: [cancelAction, confirmAction]
)
let alert = AlertViewController(viewModel: viewModel)
present(alert, animated: true)
```
See [Alert.swift](https://github.com/devpolant/NativeUI/blob/master/NativeUI/Sources/Alert/Alert.swift) for more details.
### Edge cases
When you need to present few alerts in a row you should set `shouldDismissAutomatically` flag to `false` and add action AFTER view controller initialization to be able to capture alert instance in action handler's closure.
```swift
let viewModel = Alert(
title: "Your Title",
message: "Your Message"
)
let alert = AlertViewController(viewModel: viewModel)
alert.shouldDismissAutomatically = false
let cancelAction = Alert.Action(title: "Cancel", style: .primary) { [weak alert] _ in
alert?.dismiss(animated: true) {
// present something else
}
}
alert.addAction(cancelAction)
let confirmAction = Alert.Action(title: "Confirm", style: .default) { [weak alert] _ in
alert?.dismiss(animated: true) {
// present something else
}
}
alert.addAction(confirmAction)
present(alert, animated: true)
```
## Author
Anton Poltoratskyi
## License
NativeUI is available under the MIT license. See the [LICENSE](https://github.com/devpolant/NativeUI/blob/master/LICENSE) file for more info.