TreemapKit
TreemapKit is a treemap implementation for Cocoa Touch. You can display treemaps in iPhone, iPod touch and iPad.
Click here to see the simple demo app
License
TreemapKit is provided under the MIT License.
How to use
- Copy TreemapKit folder to your source tree and add it to Xcode project.
- Import "TreemapView.h" from your code.
- Implement both TreemapViewDataSource and TreemapViewDelegate protocols.
Class References
TreemapView
reloadData
- (void)reloadData
Reload the data of the treemap.
Call this method to reload all the data that is used to construct the treemap including cells.
If you want to change the cell content, implement treemapView:updateCell:forIndex:forRect:.
TreemapViewCell
A basic implementation of the treemap cell. You can make a sub-class to show more information or images.
textLabel
UILabel *textLabel
The label used for the main textual content of the tremap cell.
valueLabel
UILabel *valueLabel
The label used to show a value of the cell.
index
NSinteger index
The cell index.
initWithFrame:
- (id)initWithFrame:(CGRect)frame
Initialize the cell with a frame.
TreemapViewDataSource
The data source protocol for a TreemapView object.
valuesForTreemapView: (required method)
- (NSArray *)valuesForTreemapView:(TreemapView *)treemapView;
Provides data for a TreemapView as a NSArray.
Tree or other data structures are currently not supported.
TreemapView:cellForIndex:forRect: (required method)
- (TreemapViewCell *)treemapView:(TreemapView *)treemapView cellForIndex:(NSInteger)index forRect:(CGRect)rect;
Returns a cell object for the specified place. You need to create a TreemapViewCell and return it.
treemapView:separatorWidthForDepth:
- (float)treemapView:(TreemapView *)treemapView separatorWidthForDepth:(NSInteger)depth;
Returns a separator width for the specified depth. If you don't need to change the width for the specified depth, return 0. The default separator width is 0.
treemapView:separationPositionForDepth:
- (NSInteger)treemapView:(TreemapView *)treemapView separationPositionForDepth:(NSInteger)depth;
Normally TreemapView separate two rectangles with calculating the areas, but if you want to separate two groups manually, return the index of the cells. If you don't need to change the separation position for the specified depth, return NSIntegerMax.
TreemapViewDelegate
The delegate of a TreemapView object.
treemapView:tapped:
- (void)treemapView:(TreemapView *)treemapView tapped:(NSInteger)index;
Tells the delegate that the specified cell is tapped.
treemapView:updateCell:forIndex:forRect:
- (void)treemapView:(TreemapView *)treemapView updateCell:(TreemapViewCell *)cell forIndex:(NSInteger)index forRect:(CGRect)rect;
Tells the delegate that the specified cell should be updated. You need to update the cell content manually in this method.