Skip to content

Easy to use and customizable messages/notifications for iOS à la Tweetbot

License

Notifications You must be signed in to change notification settings

ClickedApps/TSMessages

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TSMessages

This framework provides an easy to use class to show little notification views on the top of the screen. (à la Tweetbot).

The notification moves from the top of the screen underneath the navigation bar and stays there for a few seconds, depending on the length of the displayed text. To dismiss a notification before the time runs out, the user can swipe it to the top or just tap it.

There are 4 different types already set up for you: Success, Error, Warning, Message (take a look at the screenshots)

It is very easy to add new notification types with a different design. Add the new type to the notificationType enum, add the needed design properties to the configuration file and set the name of the theme (used in the config file and images) in TSMessagesView.m inside the switch case.

Take a look at the Example project to see how to use this library. You have to open the workspace, not the project file, since the Example project uses cocoapods.

Installation

From CocoaPods

Add pod 'TSMessages' to your Podfile.

Manually

Drag the whole folder into your project and remove the example project. This library required ARC.

To show notifications use the following code:

    [TSMessage showNotificationInViewController:self
                                      withTitle:notificationTitle
                                    withMessage:notificationDescription
                                       withType:kNotificationError];

You don't need to do anything with TSMessageView, except you want to modify the behavior or the types of the notification itself.

If you don't want a detailed description (text underneath the title) you don't need to set one. The notification will automatically resize itself properly. There are different initializer available.

Warning Success Error Message

This project requires ARC.

If you have ideas how to improve this library please let me know or send a pull request.

TODOs

  • Update width when screen orientation changes while notification is being displayed

About

Easy to use and customizable messages/notifications for iOS à la Tweetbot

Resources

License

Stars

Watchers

Forks

Packages

No packages published