jdf

JDFPeekaboo

JDFPeekaboo is a simple class that hides the navigation bar when you scroll.

Showing:

Popularity

Downloads/wk

0

GitHub Stars

298

Maintenance

Last Commit

5yrs ago

Contributors

4

Package

Dependencies

0

License

MIT

Categories

Readme

JDFPeekaboo

Version License Platform

JDFPeekaboo is a simple class that hides the navigation bar when you scroll down, and shows it again when you scroll back up. It can actually be any UIView that it hides, and it will also hide a view at the bottom of the screen as well, if you like.

Here's a little demo of it in use:

It's very easy to use. Simply add a property for it:

@property (nonatomic, strong) JDFPeekabooCoordinator *scrollCoordinator;

Then, set it up (say, in -viewDidLoad):

self.scrollCoordinator = [[JDFPeekabooCoordinator alloc] init];
self.scrollCoordinator.scrollView = self.scrollView;
self.scrollCoordinator.topView = self.navigationController.navigationBar;
self.scrollCoordinator.bottomView = self.navigationController.toolbar;

Sometimes, you may want to temporarily disable JDFPeekaboo, for example when you push another view controller onto your navigation controller. Some convenience methods are provided for disabling JDFPeekaboo (and re-enabling it). See the documentation for more info.

Documentation

You can find the docs here (on CocoaDocs).

You can also find a bit more info on my blog post

FAQ

Q: Why are there black spaces at the top/bottom of the screen, like this:

A: This happens if your table view doesn't extend behind the navigationBar/tabBar. You can fix this by setting your UIViewController/UITableViewController's edgesForExtendedLayout (to UIRectEdgeTop/UIRectEdgeBottom/UIRectEdgeAll/whatever is appropriate), or by doing the equivalent in interface builder.

Usage

To run the example project, clone the repo, and run pod install from the Example directory first.

Installation

JDFPeekaboo is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "JDFPeekaboo"

Author

Joe Fryer, joe.d.fryer@gmail.com

Twitter - JoeFryer88

License

JDFPeekaboo is available under the MIT license. See the LICENSE file for more info.

Releases

0.3

  • JDFPeekabooCoordinator now has a delegate
  • Fixed bottom bar positioning

0.2

  • Fixed some bugs (improved landscape support).
  • Improved the showing/hiding behaviour (thanks @gbhrdt).
  • Fixed some CocoaPods stuff (thanks @GorkaMM).
  • Added some convenience methods for enabling/disabling JDFPeekaboo.

0.1

Initial Release

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100