Repository files navigation

EasyTipView is a fully customizable tooltip view written in Swift that can be used as a call to action or informative tip.

1. Features
2. Installation
3. Supported OS & SDK versions
4. Usage
5. Customizing the appearance
6. Customising the presentation and dismissal animations
7. License
8. Contact

• Can be shown pointing to anyUIBarItem orUIView subclass.
• Support for any arrow direction←, →, ↑, ↓
• Automatic orientation change adjustments.
• Fully customizable appearance (custom content view or simply just text - includingNSAttributedString - see the Example app).
• Fully customizable presentation and dismissal animations.

CocoaPods is a dependency manager for Cocoa projects.

CocoaPods 0.36 adds supports for Swift and embedded frameworks. You can install it with the following command:

$ gem install cocoapods

To integrate EasyTipView into your Xcode project using CocoaPods, specify it in yourPodfile:

pod'EasyTipView','~> 2.1'

Then, run the following command:

$ pod install

In case Xcode complains ("Cannot load underlying module for EasyTipView") go to Product and choose Clean (or simply press⇧⌘K).

Carthage is a decentralized dependency manager that builds your dependencies and provides you with binary frameworks.

You can install Carthage withHomebrew using the following command:

$ brew update$ brew install carthage

To integrate EasyTipView into your Xcode project using Carthage, specify it in yourCartfile:

github "teodorpatras/EasyTipView"

Runcarthage update to build the framework and drag the builtEasyTipView.framework into your Xcode project.

If you prefer not to use either of the aforementioned dependency managers, you can integrate EasyTipView into your project manually.

• Supported build target - iOS 8+ (Xcode 8)

1. First you should customize the preferences:

varpreferences=EasyTipView.Preferences()preferences.drawing.font=UIFont(name:"Futura-Medium", size:13)!preferences.drawing.foregroundColor=UIColor.whiteColor()preferences.drawing.backgroundColor=UIColor(hue:0.46, saturation:0.99, brightness:0.6, alpha:1)preferences.drawing.arrowPosition=EasyTipView.ArrowPosition.top/* * Optionally you can make these preferences global for all future EasyTipViews */EasyTipView.globalPreferences= preferences

2. Secondly call theshow(animated: forView: withinSuperview: text: preferences: delegate:) method:

EasyTipView.show(forView:self.buttonB,withinSuperview:self.navigationController?.view,text:"Tip view inside the navigation controller's view. Tap to dismiss!",preferences: preferences,delegate:self)

Note that if you set theEasyTipView.globalPreferences, you can ommit thepreferencesparameter in all calls. Additionally, you can also ommit thewithinSuperviewparameter and theEasyTipViewwill be shown within the main application window.

Alternatively, if you want to dismiss theEasyTipView programmatically later on, you can use one of the instance methods:

lettipView=EasyTipView(text:"Some text", preferences: preferences)tipView.show(forView: someView, withinSuperview: someSuperview)// later on you can dismiss ittipView.dismiss()

In order to customize theEasyTipView appearance and behavior, you can play with thePreferences structure which encapsulates all the customizable properties of theEasyTipView. These preferences have been split into three structures:

• Drawing - encapsulates customizable properties specifying howEastTipView will be drawn on screen.
• Positioning - encapsulates customizable properties specifying whereEasyTipView will be drawn within its own bounds.
• Animating - encapsulates customizable properties specifying howEasyTipView will animate on and off screen.

The default animations for showing or dismissing are scale up and down. If you want to change the default behavior, you need to change the attributes of theanimating property within the preferences. An example could be:

preferences.animating.dismissTransform=CGAffineTransform(translationX:0, y:-15)preferences.animating.showInitialTransform=CGAffineTransform(translationX:0, y:-15)preferences.animating.showInitialAlpha=0preferences.animating.showDuration=1.5preferences.animating.dismissDuration=1.5

This produces the following animations:

For more animations, checkout the example project.Once you configured the animations, a good idea would be tomake these preferences global, for all future instances ofEasyTipView by assigning it toEasyTipView.globalPreferences.

EasyTipView is developed byTeodor Patraş and is released under the MIT license. See theLICENSE file for details.

Logo was created using Bud Icons Launch graphic byBudi Tanrim fromFlatIcon which is licensed underCreative Commons BY 3.0. Made withLogo Maker.

You can follow or drop me a line onmy Twitter account. If you find any issues on the project, you can open a ticket. Pull requests are also welcome.