Add your own walkthrough/intro/tutorial into the app
PVOnboardKit
PVOnboardKit is a framework that allows you to add your own walkthrough/intro/tutorial into your app. As the main concept uses UITableView. Also, for more customization PVOnboardKit uses TAPageControl instead of UIPageControl.
Requirements
- iOS 8 and later
Installation
To install PVOnboardKit using CocoaPods, add this line to your Podfile:
pod 'PVOnboardKit'
- Import
PVOnboardKit
- Create
PVOnboardView
and add to your view - Implement
PVOnboardViewDelegate
andPVOnboardViewDataSource
and assign to instance ofPVOnboardView
- Call reloadData from instance of
PVOnboardView
- Enjoy ?
PVOnboardPage Protocol
@optional
/**
* Invoked just after transition on the next page.
*/
- (void)willContentShow;
/**
* Invoked before transition on the next page.
*/
@optional
- (void)didContentShow;
/**
* Invoked just after transition on the next page.
*/
@optional
- (void)willContentHide;
/**
* Invoked before transition on the next page.
*/
@optional
- (void)didContentHide;
PVOnboardView Delegate Methods
@optional
/**
* Invoked after a user did touch on the left action button.
*
* @param onboardView The onboardView.
* @param index The index of the page.
*/
- (void)onboardView:(nonnull PVOnboardView *)onboardView didTouchOnLeftActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Invoked after a user did touch on the right action button.
*
* @param onboardView The onboardView.
* @param index The index of the page.
*/
- (void)onboardView:(nonnull PVOnboardView *)onboardView didTouchOnRightActionButtonAtIndex:(NSInteger)index;
PVOnboardView DataSource Methods
@required
/**
* Requests a number of pages in current onboardView.
*
* @param onboardView The onboard-view object asking for number of pages.
* @return The number of pages.
*/
- (NSInteger)numberOfPagesInOneboardView:(nonnull PVOnboardView *)onboardView NS_SWIFT_NAME(numberOfPages(in:));
@required
/**
* Requests a page view for the page at index.
*
* @param onboardView The onboard-view object asking for the view.
* @param index An index of a requested page.
* @return The view that conforms to PVOnboardPage protocol.
*/
- (nonnull UIView *)onboardView:(nonnull PVOnboardView *)onboardView viewForPageAtIndex:(NSInteger)index NS_SWIFT_NAME(onboardView(_:viewForPageAtIndex:));
@optional
/**
* Requests a visible state for the right action button for page at index.
*
* @param onboardView The onboard-view object asking for the right button
* visible state.
* @param index An index of a requested page.
* @return Return YES if a action button should be visible or NO if shouldn't.
*/
- (BOOL)onboardView:(nonnull PVOnboardView *)onboardView shouldHideRightActionButtonForPageAtIndex:(NSInteger)index;
@optional
/**
* Requests a title for the right action button for page at index.
*
* @param onboardView The onboard-view object asking for the right button title.
* @param index An index of a requested page.
* @return The string to use as a title for the right action button.
*/
- (nullable NSString *)onboardView:(nonnull PVOnboardView *)onboardView titleForRightActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests title edge insets for the right action button for page at index.
*
* @param onboardView The onboard-view object asking for the right button edge
* insets.
* @param index An index of a requested page.
* @return The edge insets to use as the title edge insets for the right
* action button.
*/
- (UIEdgeInsets)onboardView:(nonnull PVOnboardView *)onboardView titleEdgeInsetsForRightActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests an image for the right action button for page at index.
*
* @param onboardView The onboard-view object asking for the right button image.
* @param index An index of a requested page.
* @return The image to use as the image for the right action button.
*/
- (nullable UIImage *)onboardView:(nonnull PVOnboardView *)onboardView imageForRightActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests image edge insets for the right action button for page at index.
*
* @param onboardView The onboard-view object asking for the right button image
* edge insets.
* @param index An index of a requested page.
* @return The edge insets to use as the image edge insets for the right
* action button.
*/
- (UIEdgeInsets)onboardView:(nonnull PVOnboardView *)onboardView imageEdgeInsetsForRightActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests a visible state for the left action button for page at index.
*
* @param onboardView The onboard-view object asking for the left button
* visible state.
* @param index An index of a requested page.
* @return Return YES if a action button should be visible or NO if shouldn't.
*/
- (BOOL)onboardView:(nonnull PVOnboardView *)onboardView shouldHideLeftActionButtonForPageAtIndex:(NSInteger)index;
@optional
/**
* Requests a title for the left action button for page at index.
*
* @param onboardView The onboard-view object asking for the left button title.
* @param index An index of a requested page.
* @return Return the string that should use as a title.
*/
- (nullable NSString *)onboardView:(nonnull PVOnboardView *)onboardView titleForLeftActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests title edge insets for the left action button for page at index.
*
* @param onboardView The onboard-view object asking for the left button edge
* insets.
* @param index An index of a requested page.
* @return The edge insets to use as the title edge insets for the left
* action button.
*/
- (UIEdgeInsets)onboardView:(nonnull PVOnboardView *)onboardView titleEdgeInsetsForLeftActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests an image for the left action button for page at index.
*
* @param onboardView The onboard-view object asking for the left button image.
* @param index An index of a requested page.
* @return The image to use as the image for the left action button.
*/
- (nullable UIImage *)onboardView:(nonnull PVOnboardView *)onboardView imageForLeftActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests image edge insets for the left action button for page at index.
*
* @param onboardView The onboard-view object asking for the left button image
* edge insets.
* @param index An index of a requested page.
* @return The edge insets to use as the image edge insets for the left
* action button.
*/
- (UIEdgeInsets)onboardView:(nonnull PVOnboardView *)onboardView imageEdgeInsetsForLeftActionButtonAtIndex:(NSInteger)index;
@optional
/**
* Requests a bottom padding for the footer view. Default is 0.
*
* @param onboardView The onboardView.
* @return The padding to use as the footer view bottom padding.
*/
- (CGFloat)onboardViewFooterBottomPadding:(nonnull PVOnboardView *)onboardView NS_SWIFT_NAME(onboardViewFooterBottomPadding(paddingForPageAtIndex:));