barrycug / jwfolders Goto Github PK

JWFolders is a class that attempts to mimic the folder animation present on the iOS SpringBoard.

##Preview JWFolders is being used in my commercial application, QuickWeather. Depicted here is a beta version of the app:

##Usage Just include the entire folder, JWFolders, in your project. Import JWFolders.h in the class in which you wish to create the folder.

#import "JWFolders.h"

Here's a quick example of how to create a new folder and open it upwards.

JWFolders *folder = [JWFolders folder];
folder.contentView = self.sampleFolder.view;
folder.containerView = self.view;
folder.position = openPoint;
folder.direction = JWFoldersOpenDirectionUp;
folder.contentBackgroundColor = [UIColor colorWithPatternImage:[UIImage imageNamed:@"noise"]];
folder.shadowsEnabled = YES;
folder.showsNotch = YES;
[folder open]; // opens the folder.

An issue can arise if the folder is set to show the notch, and the position is set to a point with an x-coordinate of 0. The notch will appear to be cut off on the left side of the screen. This can be simply resolved by providing a non-zero x-coordinate. Most likely this will be the center of the item from which you present the folder.

Please check the header file for complete documentation.

##ARC The project currently uses Automatic Reference Counting, which means that if your project does not use ARC there will be memory leaks. There are no plans to create a non-ARC branch at this time.

##Important note

This library makes use of CALayer's renderInContext: method to render the current state of your view into an image. Unfortunately, renderInContext: does not take 3D transforms into account. If you would like this to be fixed, please file a radar.

##License JWFolders is licensed under the BSD License.

##Todo

• Finish implementing the animated notch content to complete the effect.
• Optimize the renderInContext: call. I fear this is impossible.

Please feel free to fork the project and improve it as much as possible!

##About Me I'm an 18-year-old developer and designer with a passion for great interface design and detail. See my applications, learn more about me, or get in touch. I'm on Twitter as well: @j_willing.