BPContextualHelp is a custom control based on the contextual help balloons in the pre-iOS 7 iPhoto app. It currently provides three types of annotations: a standard balloon, a balloon with a disclosure indicator, and a circular tap. Full accessibility support is provided for the annotations.

Podfile

platform :ios, '5.1'
pod "BPContextualHelp", "~> 1.0"

Requirements

BPContextualHelp 1.0 requires Xcode 5, targeting iOS 5.1 and above. It supports both ARC and non-ARC projects without requiring special build flags.

Limitations

Help annotations do not currently account for an offset being too large or for overlapping annotations.

Usage

Import the header into any file you want to show annotations from:

#import "BPContextualHelp.h"

Show an Annotation

BPHelpAnnotation *annotation = [[BPHelpAnnotation alloc] initWithDirection:BPHelpAnnotationDirectionBottom anchorView:self.aButton contentOffset:CGSizeZero andText:@"This annotation is anchored to a view."];

BPHelpOverlayView *helpOverlay = [BPHelpOverlayView helpOverlayViewWithAnnotations:@[annotation]];
helpOverlay.completionBlock = ^{
    NSLog(@"Use this block to perform an action after the help overlay is hidden");
};
[helpOverlay show];