zoukankan      html  css  js  c++  java

  • DZNEmptyDataSet的使用

    DZNEmptyDataSet是外国友人写的开源项目，github地址（具体的使用以及Demo，点击进入github主页），简单介绍下DZNEmptyDataSet的使用方法。

    对于iOS开发者来说，UITableView是在开发过程中使用比较多的一个控件。如果UITableView表视图没有数据，页面一片空白，不是一个很好的用户体验。我们都希望在数据源为空的时候，给用户一些相应的提示，提高交互效果。

    DZNEmptyDataSet就如同福音，适用于每一个iOS项目，只要遵DZNEmptyDataSetSource、 DZNEmptyDataSetDelegate这两个协议，在UITableView和UICollectionView中实现对应的代理方法就OK啦。

    DZNEmptyDataSet效果图

    一、函数调用

    1.1 数据源方法

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    78
    79
    80
    81
     *  返回占位图图片
     */
    - (UIImage *)imageForEmptyDataSet:(UIScrollView *)scrollView {
        [UIImage imageNamed:@""];
    }
     *  返回标题文字
     */
    - (NSAttributedString *)titleForEmptyDataSet:(UIScrollView *)scrollView {
        NSString *text = @"No Application Found";
        return [[NSAttributedString alloc] initWithString:text attributes:nil];
    }
     *  返回详情文字
     */
    - (NSAttributedString *)descriptionForEmptyDataSet:(UIScrollView *)scrollView {
        UISearchBar *searchBar = self.searchDisplayController.searchBar;
        
        NSString *text = [NSString stringWithFormat:@"There are no empty dataset examples for "%@".", searchBar.text];
        NSMutableAttributedString *attributedString = [[NSMutableAttributedString alloc] initWithString:text attributes:nil];
        
        [attributedString addAttribute:NSFontAttributeName value:[UIFont boldSystemFontOfSize:17.0] range:[attributedString.string rangeOfString:searchBar.text]];
        
        return attributedString;
    }
     *  返回文字按钮
     */
    - (NSAttributedString *)buttonTitleForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state {
        NSString *text = @"Search on the App Store";
        UIFont *font = [UIFont systemFontOfSize:16.0];
        UIColor *textColor = [UIColor colorWithHex:(state == UIControlStateNormal) ? @"007aff" : @"c6def9"];
        
        NSMutableDictionary *attributes = [NSMutableDictionary new];
        [attributes setObject:font forKey:NSFontAttributeName];
        [attributes setObject:textColor forKey:NSForegroundColorAttributeName];
        
        return [[NSAttributedString alloc] initWithString:text attributes:attributes];
    }
     *  返回图片按钮（如果设置了此方法，buttonTitleForEmptyDataSet: ，返回文字按钮方法就会失效
     */
    - (UIImage *)buttonImageForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state {
        return [UIImage imageNamed:@""];
    }
     *  自定义背景颜色
     */
    - (UIColor *)backgroundColorForEmptyDataSet:(UIScrollView *)scrollView {
        return [UIColor whiteColor];
    }
     *  自定义视图 （关键方法，可以做一些自定义占位视图）
     */
    //- (UIView *)customViewForEmptyDataSet:(UIScrollView *)scrollView {
    //    
    //}
     *  设置垂直或者水平方向的偏移量，推荐使用verticalOffsetForEmptyDataSet这个方法
     *
     *  @return 返回对应的偏移量（默认都为0）
     */
    - (CGPoint)offsetForEmptyDataSet:(UIScrollView *)scrollView {
        return CGPointMake(0, -64.0);
    }
     *  设置垂直方向的偏移量 （推荐使用）
     */
    - (CGFloat)verticalOffsetForEmptyDataSet:(UIScrollView *)scrollView {
        return -64.0大专栏  DZNEmptyDataSet的使用an>;
    }

    1.2 代理方法

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
     *  数据源为空时是否渲染和显示 (默认为 YES)
     */
    - (BOOL)emptyDataSetShouldDisplay:(UIScrollView *)scrollView {
        return YES;
    }
    /**
     *  是否允许点击 (默认为 YES)
     */
    - (BOOL)emptyDataSetShouldAllowTouch:(UIScrollView *)scrollView {
        return YES;
    }
    /**
     *  是否允许滚动 (默认为 NO)
     */
    - (BOOL)emptyDataSetShouldAllowScroll:(UIScrollView *)scrollView {
        return YES;
    }
    /**
     *  处理空白区域的点击事件
     */
    - (void)emptyDataSet:(UIScrollView *)scrollView didTapView:(UIView *)view {
        NSLog(@"%s",__FUNCTION__);
    }
    /**
     *  处理按钮的点击事件
     */
    - (void)emptyDataSet:(UIScrollView *)scrollView didTapButton:(UIButton *)button {
        UISearchBar *searchBar = self.searchDisplayController.searchBar;
        NSURL *URL = [NSURL URLWithString:[NSString stringWithFormat:@"http://itunes.com/apps/%@", searchBar.text]];
        
        if ([[UIApplication sharedApplication] canOpenURL:URL]) {
            [[UIApplication sharedApplication] openURL:URL];
        }
    }

    1.3 ReloadData

    当数据源发生变化是执行：

    1
    [self.tableView reloadData];

    或者

    1
    [self.collectionView reloadData];

    二、项目中使用

    2.1 实际使用的方法

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    - (void)emptyDataSetWillAppear:(UIScrollView *)scrollView {
        self.mTableView.contentOffset = CGPointZero;
    }
    - (UIImage *)imageForEmptyDataSet:(UIScrollView *)scrollView {
        return [UIImage imageNamed:@"icon_can_not_find_the_network"];
    }
    - (NSAttributedString *)buttonTitleForEmptyDataSet:(UIScrollView *)scrollView forState:(UIControlState)state {
        NSString *text = @"网络不给力，请点击重试哦~";
        UIFont *font = [UIFont systemFontOfSize:15.0];
        NSMutableAttributedString *attStr = [[NSMutableAttributedString alloc] initWithString:text];
        [attStr addAttribute:NSFontAttributeName value:font range:NSMakeRange(0, text.length)];
        [attStr addAttribute:NSForegroundColorAttributeName value:kTextLightColor range:NSMakeRange(0, text.length)];
        [attStr addAttribute:NSForegroundColorAttributeName value:kThemeColor range:NSMakeRange(7, 4)];
        return attStr;
    }
    - (void)emptyDataSet:(UIScrollView *)scrollView didTapButton:(UIButton *)button {
        // 点击重试
    }
    - (CGFloat)verticalOffsetForEmptyDataSet:(UIScrollView *)scrollView {
        return -70.0f;
    }

    2.2 效果图

    2.3 遇到的问题

    在使用过程中发现有时候出现无数据或者无网络的情况，占位图的位置并不是在屏幕设定的位置，会出现偏移的现象。

    解决思路：

    在emptyDataSetWillAppear方法中，将tableView或者scrollerView的contentOffset设为 CGPointZero

    1
    2
    3
    - (void)emptyDataSetWillAppear:(UIScrollView *)scrollView {
        self.mTableView.contentOffset = CGPointZero;
    }
  • 相关阅读:
    CUBRID学习笔记 4 端口和win7下连接数据库cubrid教程
    CUBRID学习笔记 3 net连接数据库并使用cubrid教程示例
    CUBRID学习笔记 2 安装教程
    CUBRID学习笔记 1 简介 cubrid教程
    vs无法打开项目的解决方案
    迷你sql profile，给缺少sql跟踪的朋友们
    EntityFramework 开始小试
    网站安全扫描工具--Netsparker的使用
    ServiceStack.OrmLite 笔记10-group having 分页orderby等
    pyqt5 笔记（四）cx_Freeze 实现代码打包exe
  • 原文地址：https://www.cnblogs.com/lijianming180/p/12302780.html
Copyright © 2011-2022 走看看