README.md

WYNullView

An easy way to use when view' content is empty

Overview

How to use

• Installation with CocoaPods：pod 'WYNullView'

• Import the main file：#import "WYNullView.h"

• On the empty state show default content, then all you have to do is:

if (showNullView) { // 无数据，empty data -》 show nullview
  [self.tableView wy_showNullView];
} else { // 有数据，data -》 hide nullview
  [self.tableView wy_hideNullView];
}

• You will be able to fully customize the content and appearance of the empty states for your application

if (showNullView) { // 无数据，empty data -》 show nullview
  [self.tableView wy_showNullView:^UIView *(NullView *defaultNullView) {
     // you can do any constom operation in this block, even return a new constom UIView obj 
     // rerurn [UIView new];
     defaultNullView.desText = @"基于NullView自定义";
     defaultNullView.frame = CGRectMake(10, 10, defaultNullView.frame.size.width, defaultNullView.frame.size.height);
     defaultNullView.backgroundColor = [UIColor cyanColor];
     return defaultNullView;
  } heightOffset:0.0];
} else { // 有数据，data -》 hide nullview
  [self.tableView wy_hideNullView];
}

Implementation

• UIView-Category add AssociatedObject "wy_nullView":

///> 空视图
@property (nonatomic, strong) UIView *wy_nullView;

• Looking for NullView chain:

  • + (void)wy_configGlobleNullView:(NullViewHandle)nullViewHandle
  • - (void)wy_configNullView:(NullViewHandle)nullViewHandle
  • - (void)wy_showNullView:(NullViewHandle)nullViewHandle heightOffset:(CGFloat)offset

• NullViewHandle Type:

typedef UIView *(^NullViewHandle)(NullView *defaultNullView);

• Different methods can be used in different ways:

  • Global configuration 【View object whatever it is type, show the same content from "wy_configGlobleNullView" nullViewHandle return 】:

   [UIView wy_configGlobleNullView:^UIView *(NullView *defaultNullView) {
      // return globalNullView...
   }];

  • View configuration【Once config, you can call "wy_showNullView" directly, 】

   - (void)viewDidLoad {
     [mView wy_configNullView:^UIView *(NullView *defaultNullView) {
        // return nullView...
     }];
   }
   - (void)func1 {
     ...
     [mView wy_showNullView];
     ...
   }
   - (void)func2 {
     ...
     [mView wy_showNullView];
     ...
   }

  • If you have plenty of time, you can do the following【Equivalent to the above】:

   		
   - (void)func1 {
     ...
     [mView wy_showNullView:^UIView *(NullView *defaultNullView) {
        // return nullView...
     } heightOffset:0.0]];
     ...
   }
   - (void)func2 {
     ...
     [mView wy_showNullView:^UIView *(NullView *defaultNullView) {
       // return nullView...
      } heightOffset:0.0]];
     ...
   }

• Control special subView show/hidden

  • filter obj

   // add objc_whitelist 
   [[mView wy_objWhitelist] addObject:makeWeakReference(mView_subView)];
  

  • filter class

   // add class_whitelist
   [[self.tableView wy_classWhitelist] addObject:makeWeakReference([mView_subView class])];

Hope

If you think it's useful, star to me, Free to share with ideas, issue or pull requests

License

MIT