123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108 |
- // The MIT License (MIT)
- //
- // Copyright (c) 2015-2016 forkingdog ( https://github.com/forkingdog )
- //
- // Permission is hereby granted, free of charge, to any person obtaining a copy
- // of this software and associated documentation files (the "Software"), to deal
- // in the Software without restriction, including without limitation the rights
- // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- // copies of the Software, and to permit persons to whom the Software is
- // furnished to do so, subject to the following conditions:
- //
- // The above copyright notice and this permission notice shall be included in all
- // copies or substantial portions of the Software.
- //
- // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- // SOFTWARE.
- #import <UIKit/UIKit.h>
- #import "UITableView+FDKeyedHeightCache.h"
- #import "UITableView+FDIndexPathHeightCache.h"
- #import "UITableView+FDTemplateLayoutCellDebug.h"
- @interface UITableView (FDTemplateLayoutCell)
- /// Access to internal template layout cell for given reuse identifier.
- /// Generally, you don't need to know these template layout cells.
- ///
- /// @param identifier Reuse identifier for cell which must be registered.
- ///
- - (__kindof UITableViewCell *)fd_templateCellForReuseIdentifier:(NSString *)identifier;
- /// Returns height of cell of type specifed by a reuse identifier and configured
- /// by the configuration block.
- ///
- /// The cell would be layed out on a fixed-width, vertically expanding basis with
- /// respect to its dynamic content, using auto layout. Thus, it is imperative that
- /// the cell was set up to be self-satisfied, i.e. its content always determines
- /// its height given the width is equal to the tableview's.
- ///
- /// @param identifier A string identifier for retrieving and maintaining template
- /// cells with system's "-dequeueReusableCellWithIdentifier:" call.
- /// @param configuration An optional block for configuring and providing content
- /// to the template cell. The configuration should be minimal for scrolling
- /// performance yet sufficient for calculating cell's height.
- ///
- - (CGFloat)fd_heightForCellWithIdentifier:(NSString *)identifier configuration:(void (^)(id cell))configuration;
- /// This method does what "-fd_heightForCellWithIdentifier:configuration" does, and
- /// calculated height will be cached by its index path, returns a cached height
- /// when needed. Therefore lots of extra height calculations could be saved.
- ///
- /// No need to worry about invalidating cached heights when data source changes, it
- /// will be done automatically when you call "-reloadData" or any method that triggers
- /// UITableView's reloading.
- ///
- /// @param indexPath where this cell's height cache belongs.
- ///
- - (CGFloat)fd_heightForCellWithIdentifier:(NSString *)identifier cacheByIndexPath:(NSIndexPath *)indexPath configuration:(void (^)(id cell))configuration;
- /// This method caches height by your model entity's identifier.
- /// If your model's changed, call "-invalidateHeightForKey:(id <NSCopying>)key" to
- /// invalidate cache and re-calculate, it's much cheaper and effective than "cacheByIndexPath".
- ///
- /// @param key model entity's identifier whose data configures a cell.
- ///
- - (CGFloat)fd_heightForCellWithIdentifier:(NSString *)identifier cacheByKey:(id<NSCopying>)key configuration:(void (^)(id cell))configuration;
- @end
- @interface UITableView (FDTemplateLayoutHeaderFooterView)
- /// Returns header or footer view's height that registered in table view with reuse identifier.
- ///
- /// Use it after calling "-[UITableView registerNib/Class:forHeaderFooterViewReuseIdentifier]",
- /// same with "-fd_heightForCellWithIdentifier:configuration:", it will call "-sizeThatFits:" for
- /// subclass of UITableViewHeaderFooterView which is not using Auto Layout.
- ///
- - (CGFloat)fd_heightForHeaderFooterViewWithIdentifier:(NSString *)identifier configuration:(void (^)(id headerFooterView))configuration;
- @end
- @interface UITableViewCell (FDTemplateLayoutCell)
- /// Indicate this is a template layout cell for calculation only.
- /// You may need this when there are non-UI side effects when configure a cell.
- /// Like:
- /// - (void)configureCell:(FooCell *)cell atIndexPath:(NSIndexPath *)indexPath {
- /// cell.entity = [self entityAtIndexPath:indexPath];
- /// if (!cell.fd_isTemplateLayoutCell) {
- /// [self notifySomething]; // non-UI side effects
- /// }
- /// }
- ///
- @property (nonatomic, assign) BOOL fd_isTemplateLayoutCell;
- /// Enable to enforce this template layout cell to use "frame layout" rather than "auto layout",
- /// and will ask cell's height by calling "-sizeThatFits:", so you must override this method.
- /// Use this property only when you want to manually control this template layout cell's height
- /// calculation mode, default to NO.
- ///
- @property (nonatomic, assign) BOOL fd_enforceFrameLayout;
- @end
|