Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wxxsw/gsmessages
A simple style messages/notifications, in Swift.
https://github.com/wxxsw/gsmessages
ios message notice notifications swift toast ui
Last synced: 6 days ago
JSON representation
A simple style messages/notifications, in Swift.
- Host: GitHub
- URL: https://github.com/wxxsw/gsmessages
- Owner: wxxsw
- License: mit
- Created: 2015-07-10T02:46:24.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2021-10-03T07:28:20.000Z (about 3 years ago)
- Last Synced: 2024-12-09T05:59:51.250Z (14 days ago)
- Topics: ios, message, notice, notifications, swift, toast, ui
- Language: Swift
- Homepage:
- Size: 10.3 MB
- Stars: 706
- Watchers: 21
- Forks: 64
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Demo
## Example
To show notifications use the following code:
```Swift
self.showMessage("Something success", type: .success)
```
To display a notice on a view:
```Swift
view.showMessage("Something success", type: .success)
```
To hide a notification manually:
```Swift
self.hideMessage()
```
#### Options (Current setting is default value):
- type : success / error / warning / info
- animation : slide(.normal) / slide(.distance(50)) / fade
- position : top / bottom
- textAlignment : topLeft / topCenter / topRight / left / center / right / bottomLeft / bottomCenter / bottomRight
```Swift
self.showMessage("String or NSAttributedString", type: .success, options: [
.accessibilityIdentifier(nil),
.animations([.slide(.normal)]),
.animationDuration(0.3),
.autoHide(true),
.autoHideDelay(3.0),
.cornerRadius(0.0),
.height(44.0),
.hideOnTap(true),
.handleTap({}),
.isInsideSafeAreaInsets(true),
.margin(.zero),
.padding(.init(top: 10, left: 30, bottom: 10, right: 30)),
.position(.top),
.textAlignment(.center),
.textColor(.white),
.textNumberOfLines(1),
])
```
## Font / Background Color
To set custom fonts and background colors in the following ways:
```Swift
GSMessage.font = UIFont.boldSystemFont(ofSize: 14)
GSMessage.successBackgroundColor = UIColor(red: 142.0/255, green: 183.0/255, blue: 64.0/255, alpha: 0.95)
GSMessage.warningBackgroundColor = UIColor(red: 230.0/255, green: 189.0/255, blue: 1.0/255, alpha: 0.95)
GSMessage.errorBackgroundColor = UIColor(red: 219.0/255, green: 36.0/255, blue: 27.0/255, alpha: 0.70)
GSMessage.infoBackgroundColor = UIColor(red: 44.0/255, green: 187.0/255, blue: 255.0/255, alpha: 0.90)
```
## Requirements
### Master
- iOS 8.0+
- Xcode 11+ (Swift 5.x)
### [1.7.1](https://github.com/wxxsw/GSMessages/tree/1.7.1)
- iOS 8.0+
- Xcode 10.0+ (Swift 4.2)
### [1.5.1](https://github.com/wxxsw/GSMessages/tree/1.5.1)
- iOS 8.0+
- Xcode 9.0+ (Swift 4.0)
### [1.3.5](https://github.com/wxxsw/GSMessages/tree/1.3.5)
- iOS 8.0+
- Xcode 8.0+ (Swift 3.x)
### [1.2.4](https://github.com/wxxsw/GSMessages/tree/1.2.4)
- iOS 7.0+
- Xcode 7.3+ (Swift 2.x)
## Installation
### [CocoaPods](http://cocoapods.org/):
In your `Podfile`:
```
source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '8.0'
use_frameworks!
pod "GSMessages"
```
And in your `*.swift`:
```swift
import GSMessages
```
### [Carthage](https://github.com/Carthage/Carthage):
In your `Cartfile`:
```
github "wxxsw/GSMessages"
```
And in your `*.swift`:
```swift
import GSMessages
```
## License
GSMessages is available under the MIT license. See the LICENSE file for more info.