Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Apply a "tutorial screen" overlay to your application window.
branch: master

Edit README.

- Change header sizes.
- Add Bitdeli badge.
latest commit f884f90805
Brian Gesiak authored

README.md

MDCFocusView

Bitdeli Badge

Apply a "tutorial screen" overlay to your application window. MDCFocusView can apply a focus on an arbitrary number of views, and prevents users from tapping views not currently focused on.

Check out a demo on Vimeo.

How to Use

You can install the project using Cocoapods, by placing pod MDCFocusView in your Podfile. After installing:

// Initialize MDCFocusView and customize its background color
MDCFocusView *focusView = [MDCFocusView new];
focusView.backgroundColor = [UIColor colorWithRed:0.0f green:0.0f blue:0.0f alpha:0.8f];

// Register a MDCFocalPointView subclass to "wrap" focal points
focusView.focalPointViewClass = [MDCSpotlightView class];

// Add any number of custom views to MDCFocusView
[focusView addSubview:[self buildLabel]];

// Present the focus view
[self.focusView focus:someView, anotherView, nil];

Please see the sample app for an example.

Features

  • Because MDCFocusView uses MDCFocalPointView to wrap focal points, it is highly extensible--to create your own focus effect, simply subclass MDCFocalPointView and implement any custom drawing behavior in drawRect:. Please see MDCSpotlightView for an example.

Limitations (or Ways to Contribute to this Project)

  • Currently MDCFocusView can only be applied to the entire application window. Ideally, any arbirary view should be able to add MDCFocusView as a subview.
  • Currently only MDCFocalPointView and MDCSpotlightView are available, although I would like to make more. It would be nice, for example, if a Gaussian blur could be applied everywhere but the focal points.
  • See the GitHub issues for more bugs/feature requests you can help with.
Something went wrong with that request. Please try again.