A lightweight callout view class for iOS mimicking UICalloutView.
Switch branches/tags
Pull request Compare This branch is 95 commits behind nfarina:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Example Screenshot


SMCalloutView aims to be an exact replica of the private UICalloutView system control.

We all love those "bubbles" you get when clicking pins in MKMapView. But sadly, it's impossible to present this bubble-style "Callout" UI anywhere outside MKMapView. Phooey! So this class painstakingly recreates this handy control for your pleasure.


To use SMCalloutView in your own projects, simply copy the files SMCalloutView.h and SMCalloutView.m.

The comments in SMCalloutView.h do a lot of explaining on how to use the class, but the main function you'll need is presentCalloutFromRect:. You'll specify the view you'd like to add the callout to, as well as the rect defining the "target" that the popup should point at. The target rect should be in the coordinate system of the target view (just like the similarly-named UIPopover method). Most likely this will be target.frame if you're adding the callout view as a sibling of the target view, or it would be target.bounds if you're adding the callout view to the target itself.

You can study the included project's AppDelegate.m for a working example.


How do I change the height of the callout?

If you use only the title/titleView/subtitle/subtitleView properties, the callout will always be the "system standard" height. If you assign the contentView property however, then the callout will size to fit the contentView and the other properties are ignored.

Can I use the callout with the Google Maps iOS SDK?

Check out ryanmaxwell's demo proejct for an example of one way to do this. More discussion on this topic

Have you recreated more of MapKit?

No, but you might be interested in MapBox's iOS SDK, which uses SMCalloutView as part of its custom open source variation of MapKit.

More Info

You can read more info if you wish in the blog post.

ARC Support

This class requires LLVM 4.0 with Automatic Reference Counting (ARC), enabled by default in modern Xcode projects.