Description
PRGTipView is a drop-in solution for adding onboarding tips to your apps. It supports:
- Title, detail and dismissal button
- Give focus on a particular view with configurable insets
- Automatic placement of title, detail and the button above or below the focused view (if provided)
- Presentation and dismissal animations
- Focus view pulsating effect (using the Pulsar Library)
PRGTipView alternatives and similar libraries
Based on the "UI" category.
Alternatively, view PRGTipView alternatives based on common mentions on social networks and blogs.
-
Lottie
An iOS library to natively render After Effects vector animations -
iCarousel
A simple, highly customisable, data-driven 3D carousel for iOS and Mac OS -
IGListKit
A data-driven UICollectionView framework for building fast and flexible lists. -
AsyncDisplayKit
Smooth asynchronous user interfaces for iOS apps. -
SVProgressHUD
A clean and lightweight progress HUD for your iOS and tvOS app. -
DZNEmptyDataSet
A drop-in UITableView/UICollectionView superclass category for showing empty datasets whenever the view has no content to display -
IQKeyboardManager
Codeless drop-in universal library allows to prevent issues of keyboard sliding up and cover UITextField/UITextView. Neither need to write any code nor any setup required and much more. -
animated-tab-bar
:octocat: RAMAnimatedTabBarController is a Swift UI module library for adding animation to iOS tabbar items and icons. iOS library made by @Ramotion -
TTTAttributedLabel
A drop-in replacement for UILabel that supports attributes, data detectors, links, and more -
SkeletonView
☠️ An elegant way to show users that something is happening and also prepare them to which contents they are awaiting -
folding-cell
:octocat: 📃 FoldingCell is an expanding content cell with animation made by @Ramotion -
FSCalendar
A fully customizable iOS calendar library, compatible with Objective-C and Swift -
NVActivityIndicatorView
A collection of awesome loading animations -
MGSwipeTableCell
An easy to use UITableViewCell subclass that allows to display swippable buttons with a variety of transitions. -
JTAppleCalendar
The Unofficial Apple iOS Swift Calendar View. Swift calendar Library. iOS calendar Control. 100% Customizable -
LTMorphingLabel
[EXPERIMENTAL] Graceful morphing effects for UILabel written in Swift. -
SWTableViewCell
An easy-to-use UITableViewCell subclass that implements a swippable content view which exposes utility buttons (similar to iOS 7 Mail Application) -
ViewAnimator
ViewAnimator brings your UI to life with just one line -
JVFloatLabeledTextField
UITextField subclass with floating labels - inspired by Matt D. Smith's design: http://dribbble.com/shots/1254439--GIF-Mobile-Form-Interaction?list=users -
SwiftMessages
A very flexible message bar for UIKit and SwiftUI. -
XLForm
XLForm is the most flexible and powerful iOS library to create dynamic table-view forms. Fully compatible with Swift & Obj-C. -
FSPagerView
FSPagerView is an elegant Screen Slide Library. It is extremely helpful for making Banner View、Product Show、Welcome/Guide Pages、Screen/ViewController Sliders. -
SwipeCellKit
Swipeable UITableViewCell/UICollectionViewCell based on the stock Mail.app, implemented in Swift. -
SVPullToRefresh
Give pull-to-refresh & infinite scrolling to any UIScrollView with 1 line of code. -
Koloda
KolodaView is a class designed to simplify the implementation of Tinder like cards on iOS. -
SideMenu
Simple side/slide menu control for iOS, no code necessary! Lots of customization. Add it to your project in 5 minutes or less. -
Alerts & Pickers
Advanced usage of UIAlertController and pickers based on it: Telegram, Contacts, Location, PhotoLibrary, Country, Phone Code, Currency, Date... -
SCLAlertView-Swift
Beautiful animated Alert View. Written in Swift -
SwiftEntryKit
SwiftEntryKit is a presentation library for iOS. It can be used to easily display overlays within your iOS apps. -
PageMenu
A paging menu controller built from other view controllers placed inside a scroll view (like Spotify, Windows Phone, Instagram) -
ViewDeck
An implementation of the sliding menu found in various iOS apps. -
Macaw
Powerful and easy-to-use vector graphics Swift library with SVG support -
AMScrollingNavbar
Scrollable UINavigationBar that follows the scrolling of a UIScrollView -
TPKeyboardAvoiding
A drop-in universal solution for moving text fields out of the way of the keyboard in iOS -
TextFieldEffects
Custom UITextFields effects inspired by Codrops, built using Swift -
Material Components
[In maintenance mode] Modular and customizable Material Design UI components for iOS -
SWRevealViewController
A UIViewController subclass for presenting side view controllers inspired on the FaceBook and Wunderlist apps, done right ! -
expanding-collection
:octocat: ExpandingCollection is an animated material design UI card peek/pop controller. iOS library made by @Ramotion -
CSStickyHeaderFlowLayout
UICollectionView replacement of UITableView. Do even more like Parallax Header, Sticky Section Header. Made for iOS 7.
InfluxDB - Power Real-Time Data Analytics at Scale
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of PRGTipView or a related project?
README
PRGTipView
PRGTipView is a drop-in solution for adding onboarding tips to your apps. It supports:
- Title, detail and dismissal button
- Give focus on a particular view with configurable insets
- Automatic placement of title, detail and the button above or below the focused view (if provided)
- Presentation and dismissal animations
- Focus view pulsating effect (using the Pulsar Library)
[](PRGTipView.gif)
Example
To run the example project, clone the repo, and run pod install
from the Example directory first.
Requirements
- iOS 9.3+
- Swift 5
Installation
PRGTipView is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'PRGTipView'
Usage
//1. Create a PRGTipViewConfiguration instance
let config = PRGTipViewConfiguration()
//2. Customize the TipView via the properties
config.titleText = "This is a title"
config.detailText = "This is the detail text, that adds more information to your tip."
config.buttonText = "OK"
config.focusView = button
config.focusInsets = UIEdgeInsets(top: 8, left: 4, bottom: 8, right: 4)
config.focusDistance = 50
config.circularFocus = false
config.animateIn = true
config.animateOut = true
//3a. You can either use the static func TipView.show like described below:
PRGTipView.show(fromViewController: self, withConfiguration: config, completion: nil)
//3b. Or you can create a PRGTipView instance and present it (it's a ViewController subclass)
let tipView = PRGTipView(configuration: config)
present(tipView, animated: false, completion: nil)
Configuration Properties
PRGTipViewConfiguration contains properties that help customize the presenting tip view:
PROPERTY | TYPE | DEFAULT VALUE | EXPLANATION |
---|---|---|---|
backgroundColor | UIColor | .black | The background color of the Tip View |
backgroundAlpha | CGFloat | 0.85 | The background alpha of the Tip View |
tipTextYSpacing | CGFloat | 30 | The vertical spacing between the Tip View Title, Detail and Button |
titleText | String? | The string to be shown as the Tip View title | |
titleTextFont | UIFont | systemFont(ofSize: 25) | The font of the Tip View title |
titleTextColor | UIColor | .white | The color of the Tip View title |
attributedTitleText | NSAttributedString? | The attributed string to be shown as the Tip View title. If set, it overrides "titleText", "titleTextFont" and "titleTextColor" properties | |
detailText | String? | The string to be shown as the Tip View detail | |
detailTextFont | UIFont | systemFont(ofSize: 29) | The font of the Tip View detail |
detailTextColor | UIColor | .white | The color of the Tip View detail |
attributedDetailText | NSAttributedString? | The attributed string to be shown as the Tip View detail. If set, it overrides "detailText", "detailTextFont" and "detailTextColor" properties | |
buttonText | String? | The string to be shown as the Tip View dismissal button title | |
buttonTextFont | UIFont | boldSystemFont(ofSize: 14) | The font of the Tip View dismissal button |
buttonTextColor | UIColor | .white | The color of the Tip View dismissal button |
attributedButtonText | NSAttributedString? | The attributed string to be shown as the Tip View dismissal title. If set, it overrides "buttonText", "buttonTextFont" and "buttonTextColor" properties | |
focusView | UIView? | The UIView to be focused when the Tip View is presented | |
circularFocus | Bool | false | If a "focusView" is provided, this property controls whether the mask used to focus on the view should be circular. In default "false" state, the mask is rectangular |
useLargestDimension | Bool | true | If "circularFocus" is set to true for a non square "focusView", leaving this property to "true" will use the "focusView"'s largest dimension to calculate the focus mask radius, while setting it to "false" will use the smallest dimension and centre the circular mask on the "focusView". |
focusInsets | UIEdgeInsets | .zero | Adds padding to the "focusView" mask. If "circularFocus" is set to "true", then it adds only the .top inset to the radius calculation. |
animateIn | Bool | true | Whether the Tip View should be presented animated. Helpful in situations where you want to chain several Tip Views and you do not want to repeat the animation on each and every one of them. |
animateOut | Bool | true | Whether the Tip View should be dismissed animated. Helpful in situations where you want to chain several Tip Views and you do not want to repeat the animation on each and every one of them. |
pulseMode | Enum | .none | Whether the "focusView", if provided, should pulse. |
focusDistance | CGfloat | 0 | The vertical spacing between the "focusView" and the container of the actual Tip Texts (Title, Detail, Button). If the provided "focusView" is in the bottom half of the screen, the tip container is presented above it and this property is the distance from the bottom of the tip container to the top of the "focusView" mask. If the provided "focusView" is in the top half of the screen, the tip container is presented below it and this property is the distance from the top of the tip container to the bottom of the "focusView" mask. |
tipContainerLeading | CGFloat | 20 | The spacing between the container of the actual Tip Texts (Title, Detail, Button) to it's superView's leading. |
tipContainerTrailing | CGFloat | 20 | The spacing between the container of the actual Tip Texts (Title, Detail, Button) trailing to it's superView's trailing. |
animationDuration | Double | 0.3 | The duration of any animation that takes place in the Tip View (except from the pulsating effect) |
buttonAction | (()->())? | The code to be executed after the Tip View is dismissed |
About the Pulsar Library
At the time of publishing PRGTipView, the Pulsar library has not been updated on the Cocoapods repositories and cannot be used as a direct dependency, thus resorting in including the v2.0.5 source code in the bundle. As soon as the dependencies are satisfied via Cocoapods, we will update PRGTipView to use Pulsar as a pod dependency.
License
PRGTipView is made for Programize LLC by John Spiropoulos and it is available under the MIT license.
This product includes Pulsar code by Vincent Esche. License information is stored here: [LICENSE](LICENSE)
*Note that all licence references and agreements mentioned in the PRGTipView README section above
are relevant to that project's source code only.