A lightweight callout view class for iOS mimicking UICalloutView.
Objective-C Ruby
Switch branches/tags
Nothing to show
Pull request Compare This branch is 24 commits ahead, 109 commits behind nfarina:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



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.


SMCalloutView now supports greater customization.

  • Instead of using a title and subtitle, these views can be replaced by setting the contentView.
  • The callout view will resize to fit both the contentView and a custom subtitleView.
  • Set the opacity, fillColor, or borderColor to match the look you want.

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.