Skip to content
Native alert from Apple Music & Feedback. Contains Done, Heart & Message and other presets.
Swift Other
  1. Swift 98.8%
  2. Other 1.2%
Branch: master
Clone or download
Latest commit e925caa Feb 13, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Update FUNDING.yml Nov 18, 2019
Assets Remove .magic preset Jan 10, 2020
Example Remove .magic preset Jan 10, 2020
SPAlert.xcodeproj Remove .magic preset Jan 10, 2020
Source Update to 2.1.2 Feb 13, 2020
.gitignore Update gitignore Aug 14, 2019
LICENSE Initial commit Apr 28, 2019
Package.swift Update source Nov 18, 2019
Readme.md Update Readme.md Feb 2, 2020
SPAlert.podspec Update to 2.1.2 Feb 13, 2020

Readme.md

SPAlert

Popup from Apple Music & Feedback in AppStore. Contains Done, Heart, Error and other presets. Support Dark Mode. I clone Apple's alerts as much as possible. You can find this alerts in AppStore after feedback and after added song to library in Apple Music.

And other

If you like the project, do not forget to put star ★ and follow me on GitHub. To help project, see Сooperation section.

Check example usage in app Debts - Spending tracker for iOS and macOS. You can buy source code this apps in my store for iOS developers:

xcode-shop.com https://github.com/ivanvorobei

Navigate

Requirements

Swift 4.2 & 5.0. Ready for use on iOS 10+

Installation

CocoaPods:

CocoaPods is a dependency manager for Cocoa projects. For usage and installation instructions, visit their website. To integrate SPAlert into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'SPAlert'

Swift Package Manager

The Swift Package Manager is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.

To integrate SPAlert into your Xcode project using Xcode 11, specify it in File > Swift Packages > Add:

https://github.com/ivanvorobei/SPAlert

Carthage

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks. To integrate SPAlert into your Xcode project using Carthage, specify it in your Cartfile:

github "ivanvorobei/SPAlert"

Manually

If you prefer not to use any of dependency managers, you can integrate SPAlert into your project manually. Put Source/SPAlert folder in your Xcode project. Make sure to enable Copy items if needed and Create groups.

Quick Start

For best experience, I recommend call alerts by SPAlert. These functions are updated regularly and show as Apple way. I focus on presets:

SPAlert.present(title: "Added to Library", preset: .done)

If you want use custom image, use func:

SPAlert.present(title: "Love", message: "We'll recommend more like this in For You", image: UIImage(named: "Heart")!)

For show simple text message, use:

SPAlert.present(message: "Empty UITextField")

Usage

Sometimes it may require deep customization. In this section, I will show you what you can do.

Duration

To change the time that the SPAlert will be shown, use property duration:

let alertView = SPAlertView(title: "Added to Library", message: nil, preset: SPAlertPreset.done)
alertView.duration = 3
alertView.present()

Dark Mode

Dark Mode no need additional configuration. As soon as the user change the interface to dark, all alerts will appear dark.

For check state of user appearance I am use traitCollection:

if self.traitCollection.userInterfaceStyle == .dark {
    return true
}

It available since iOS 12, for early using always Light Mode.

Layout

Here you can change the sizes and spaces:

alertView.layout.topSpace = 18
alertView.layout.iconHeight = 25

For more properties see class.

Dismiss by Tap

If you click on the alert, it will disappear ahead of time. This can be disabled:

alertView.dismissByTap = false

Haptic

If you use presets, the vibro-response will be start automatically. For customize this, you need set property haptic:

alertView.haptic = .success

For disable haptic, set it to .none.

Corner Radius

I use a corner radius like an Apple. If you need to change it, see the property cornerRadius:

alertView.layer.cornerRadius = 40

Сooperation

The development of this project is completely free. If you can make a contribution, it will help development. Here list of task what need do:

  • Fix mistakes in this Readme and docs. My English so bad. Good create pull request.
  • Add docs in source files. Description of public methods and parametrs.
  • Help me translate my app Debts - Spending tracker for other languages.

License

SPAlert is released under the MIT license. Check LICENSE.md for details.

You can’t perform that action at this time.