9

UIButton 状态新解

 4 years ago
source link: https://musicfe.dev/uibutton/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
neoserver,ios ssh client

云音乐大前端专栏

UIButton 状态新解

2020-10-14

题图

本文作者：谭歆

0x0 控件状态

作为 iOS 开发者，一提到控件，就不得不提到 UIButton，它做为 iOS 系统最常用的响应用户点击操作的控件，为我们提供了相当丰富的功能以及可定制性。而我们的日常工作的 80% ~ 90% 做是在与 UI 打交道，处理控件在用户的不同操作下的不同状态，最简单的，比如用户没有登录时，按钮置灰不可点击，用户点击时出现一个反色效果反馈到用户等等。对常用状态的定义，系统在很早的时候就给出了：

typedef NS_OPTIONS(NSUInteger, UIControlState) {
    UIControlStateNormal       = 0,
    UIControlStateHighlighted  = 1 << 0,                  // used when UIControl isHighlighted is set
    UIControlStateDisabled     = 1 << 1,
    UIControlStateSelected     = 1 << 2,                  // flag usable by app (see below)
    UIControlStateFocused API_AVAILABLE(ios(9.0)) = 1 << 3, // Applicable only when the screen supports focus
    UIControlStateApplication  = 0x00FF0000,              // additional flags available for application use
    UIControlStateReserved     = 0xFF000000               // flags reserved for internal framework use
};

我们一般预先设置好 UIButton 在不同状态下的样式，然后直接改对应状态的 bool 值即可，使用上比较方便。

UIButton *button = [UIButton buttonWithType:UIButtonTypeCustom];
// 正常状态
[button setTitleColor:[UIColor blueColor] forState:UIControlStateNormal];
// 点击高亮
[button setTitleColor:[UIColor whiteColor] forState:UIControlStateHighlighted];
[button setBackgroundImage:[UIImage imageNamed:@"btn_highlighted"] forState:UIControlStateHighlighted];
// 不可用
[button setTitleColor:[UIColor grayColor] forState:UIControlStateDisabled];

// 用户登录状态变化时，修改属性值
if (/* 用户未登录 */) {
  button.enabled = NO;
} else {
  button.enabled = YES;
}

那么 UIButton 只有四种状态可用吗？真实开发中，控件的状态可能很多，四种是一定不够用的。

0x1 状态组合

首先我们注意到，UIControlState 的定义是一个 NS_OPTIONS，而不是 NS_ENUM，三个有效的 bit 两两组合应该有 8 种状态。正好我们可以写个 Demo 测试一下：

UIButton *btn = [UIButton buttonWithType:UIButtonTypeCustom];

[btn setTitle:@"Normal" forState:UIControlStateNormal];
[btn setTitle:@"Selected" forState:UIControlStateSelected];
[btn setTitle:@"Highlighted" forState:UIControlStateHighlighted];
[btn setTitle:@"Highlighted & Disabled" forState:UIControlStateHighlighted | UIControlStateDisabled];
[btn setTitle:@"Disabled" forState:UIControlStateDisabled];
[btn setTitle:@"Selected & Disabled" forState:UIControlStateSelected | UIControlStateDisabled];
[btn setTitle:@"Selected & Highlighted & Disabled" forState:UIControlStateSelected | UIControlStateHighlighted | UIControlStateDisabled];
[btn setTitle:@"Selected & Highlighted" forState:UIControlStateSelected | UIControlStateHighlighted];

实践证明，

  • UIControlStateHighlighted 跟 UIControlStateHighlighted | UIControlStateDisabled
  • UIControlStateSelected | UIControlStateHighlighted 跟 UIControlStateSelected | UIControlStateHighlighted | UIControlStateDisabled

效果是一样的，相互覆盖掉。

ControlState

其实也好理解，因为 UIControlStateDisabled 与 UIControlStateHighlighted 本来语义上就不应该共存，所以剩下六种可用的状态组合。另外，在实践中发现，当某个状态没有设置样式时，它会以 Normal 状态的样式兜底，因此在日常开发中，我们最好将所有用到的状态都设置上对应的样式。

0x2 自定义状态

有了以上组合后，我们基本上可以覆盖 90% 的日常开发，但是如果需要用到更多状态呢？

我们在开发 音街 的个人主页时就遇到了状态不够用的问题，对一个关注按钮，它有以下几种不同的状态（如下图）：

  1. 当前登录用户没有关注该用户
  2. 当前登录用户正在关注该用户
  3. 当前登录用户已经关注该用户
  4. 当前登录用户与该用户互相关注
关注状态

这样一来用户可以操作的状态就有三种了，而且每种可操作的状态都有相应的高亮样式，于是我们无法仅仅用 selected 状态来表示是否已经关注。对于这种需求，一个比较容易想到的办法是在不同数据下，修改同一种状态下的样式：

[button setTitle:@"关注" forState:UIControlStateNormal];
[button setTitle:@"已关注" forState:UIControlStateSelected];

// 关注状态变化时
button.selected = YES;
if (/* 对方也关注了我 */) {
    [button setTitle:@"互相关注" forState:UIControlStateSelected];
}

需求是实现了，但控件的使用上不再简单，我们不能在初始化时设置完所有的状态，然后以数据驱动状态，状态驱动样式了，而要增加其他逻辑，并且这种增加很容易产生 Bug。

有没有更好的办法来自定义状态，以实现==样式只设置一次==？

回头看一下 UIControlState 的定义，有一个 UIControlStateApplication 好像从来没有用过，是不是可以用来自定义呢？

我们重用 selected 状态作为我们的已关注 followed 状态，同时新增 loading 关注中状态，和 mutual 互相关注状态。

enum {
    NKControlStateFollowed  = UIControlStateSelected,
    NKControlStateMutual    = 1 << 16 | UIControlStateSelected,
    NKControlStateLoading   = 1 << 17 | UIControlStateDisabled,
};


@interface NKLoadingButton : UIButton
@property (nonatomic, getter=isLoading) BOOL loading;
@property (nonatomic) UIActivityIndicatorView *spinnerView;
@end


@interface NKFollowButton : NKLoadingButton
@property (nonatomic, getter=isMutual) BOOL mutual;
@end

这里的定义需要作以下说明：

首先，为什么做移位 16 的操作？因为 UIControlStateApplication 的值是 0x00FF0000，移位 16 （16 到 23 均为合法值）正好让状态位落在它的区间内。

其次，loading 时用户应该是不能点击操作的，所以它要 或 上 disabled 状态，mutual 时一定是已经 followed 的了（即 selected），所以它要 或 上 selected。

最后，loading 状态应该其他地方也能复用，因此在继承关系上单独又拆了一层 NKLoadingButton。

NKLoadingButton 的实现比较简单，需要注意的是，我们要重写 -setEnabled: 方法让它在 loading 时同时处于不可点击状态。

@implementation NKLoadingButton

 - (UIControlState)state
{
    UIControlState state = [super state];
    
    if (self.isLoading) {
        state |= NKControlStateLoading;
    }
    
    return state;
}

- (void)setEnabled:(BOOL)enabled
{
    super.enabled = !_loading && enabled;
}

- (void)setLoading:(BOOL)loading
{
    if (_loading != loading) {
        _loading = loading;
        
        super.enabled = !loading;
        
        if (loading) {
            [self.spinnerView startAnimating];
        } else {
            [self.spinnerView stopAnimating];
        }
        
        [self setNeedsLayout];
        [self invalidateIntrinsicContentSize];
    }
}

@end

NKFollowButton 的实现如下：

@implementation NKFollowButton

- (instancetype)initWithFrame:(CGRect)frame
{
    self = [super initWithFrame:frame];
    if (self) {        
        [self setTitle:@"关注" forState:UIControlStateNormal];
        [self setTitle:@"已关注" forState:UIControlStateSelected];
        [self setTitle:@"已关注" forState:UIControlStateSelected | UIControlStateHighlighted];
        [self setTitle:@"互相关注" forState:NKControlStateMutual];
        [self setTitle:@"互相关注" forState:NKControlStateMutual | UIControlStateHighlighted];

        [self setTitle:@"" forState:NKControlStateLoading];
        [self setTitle:@"" forState:NKControlStateLoading | UIControlStateSelected];

        [self setTitle:@"" forState:NKControlStateMutual | NKControlStateLoading];
        
        // 以下省略颜色相关设置
    }
    return self;
}

- (UIControlState)state
{
    UIControlState state = [super state];
    
    if (self.isMutual) {
        state |= NKControlStateMutual;
    }
    
    return state;
}

- (void)setSelected:(BOOL)selected
{
    super.selected = selected;
    if (!selected) {
        self.mutual = NO;
    }
}

- (void)setMutual:(BOOL)mutual
{
    if (_mutual != mutual) {
        _mutual = mutual;
        
        if (mutual) {
            self.selected = YES;
        }
        
        [self setNeedsLayout];
        [self invalidateIntrinsicContentSize];
    }
}

@end

我们需要重写 -state 方法让外界拿到完整、正确的值，重写 -setSelected: 方法和 -setMutual: 方法，让它们在某些条件下互斥，某些条件下统一。

如此，我们实现了只在 -init 中设置一次样式，后续仅仅依据服务端返回的数据修改 .selected .loading .mutual 的值即可！

0x3 总结

本文从单一状态，到组合状态，到自定义状态层层深入了介绍了 UIButton 的状态在日常开发中的应用，只用状态来驱动 UI 一直是程序员开发中的美好设想，本文算是从一个基本控件上给出了实现参考。另外，我们在查看一些系统提供的 API 时，一定要多思考苹果这么设计的意图是什么？他们希望我们怎么使用，以及如何正确使用？

本文发布自 网易云音乐大前端团队，文章未经授权禁止任何形式的转载。我们常年招收前端、iOS、Android，如果你准备换工作，又恰好喜欢云音乐，那就加入我们 grp.music-fe(at)corp.netease.com！


report

Recommend

  • 53
    • 新浪科技 tech.sina.com.cn 5 years ago
    • Cache

    火星大气损失有新解 能更好评估红色星球宜居性

    火星大气损失有新解 能更好评估红色星球宜居性

  • 56
    • www.tuicool.com 5 years ago
    • Cache

    UIButton 状态小结

    我们先从一个问题说起，小明同学接到产品的一个新需求：实现一个 UIButton ，要求在 normal、selected、highlighted 三种状态下展示不同文案。这简直太简单了，小明同学1分钟不到就实现了，关键代码如下：

  • 5
    • nakeman.cn 4 years ago
    • Cache

    编程模式新解

    我们爱有经验，尤其是丰富经验，包括生活经验，和工作经验。因为经验能扫除阴暗、未知和危险，能给人安全和幸福。然，什么是经验？丰富经验如何获得？最近的学习发现，原来 我们开发者社区常讨论的 「模式」 就是工作经验的一种表现。掌握某种作业模式，就是获...

  • 10
    • www.jiguo.com 4 years ago
    • Cache

    太实用！iPhone迎来全新解锁方式，戴口罩也能秒开

    太实用！iPhone迎来全新解锁方式，戴口罩也能秒开-极果 太实用！iPhone迎来全新解锁方式，戴口罩也能秒开...

  • 7
    • finance.sina.com.cn 4 years ago
    • Cache

    全新解锁方式来了！苹果发iOS14大更新：拯救iPhone12

    全新解锁方式来了！苹果发iOS14大更新：拯救iPhone12 2021年03月24日07:23  快科技2018   我有话说(35人参与) 收藏本文...

  • 9
    • ourai.ws 3 years ago
    • Cache

    欧雷说：「“Meta framework”新解🙂」

    欧雷说：「“Meta framework”新解🙂」 欧雷 发表于 2021-10-29 17:28 评论基础模式加载中... 如需完整体验请针对 disq.us | disquscdn.com | disqus.com 启用...

  • 5
    • www.yunyingpai.com 3 years ago
    • Cache

    新解：不谋全局者不足谋一域

    导语：作为一名运营人，你的思维是怎样的，你的思维正在悄悄的改变着你，我们一起来看看过来人给的经验，带给我们运营人的启发，有幸涨工资噢，小伙伴快来看看吧！

  • 4
    • www.36kr.com 3 years ago
    • Cache

    二元经济新解：如何占领数字经济发展新高点？

    二元经济新解：如何占领数字经济发展新高点？36氪领读·2022-04-17 11:28数字和智慧经济的兴起，不是技术的边际改进，不是小修小补的经济结构调整，而是一次生产、...

  • 7
    • qiankunli.github.io 3 years ago
    • Cache

    《数据结构与算法之美》——算法新解

    建议看下前文 《数据结构与算法之美》——数据结构笔记 思考的过程比结论更重要。 字符串匹配 先将主串拆分为 n-m+1 个子串...

  • 4
    • www.niaogebiji.com 2 years ago
    • Cache

    花西子终于等回李佳琦｜消费新解

    花西子终于等回李佳琦｜消费新解-鸟哥笔记 首页 >

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK