jkpang/ppnumberbutton

iOS中一款高度可定制性商品计数按钮(京东/淘宝/饿了么/美团外卖/百度外卖样式)

iOS中一款高度可定制性商品计数按钮,使用简单!

• 支持自定义加/减按钮的标题内容、背景图片;
• 支持设置边框颜色;
• 支持使用键盘输入;
• 支持长按加/减按钮快速加减;
• 支持block回调与delegate(代理)回调;
• 支持使用xib创建、直接在IB面板设置相关属性;
• 支持设置maxValue(最大值)与minValue(最小值).
• 支持按钮自定义为京东/淘宝样式,饿了么/美团外卖/百度外卖样式;

新建 PP-iOS学习交流群 : 323408051 有关于PP系列封装的问题和iOS技术可以在此群讨论

简书地址 ;

如果你需要Swift版本,请戳: https://github.com/jkpang/PPNumberButtonSwift

Requirements 要求

• iOS 7+
• Xcode 8+

Installation 安装

1.手动安装:

下载DEMO后,将子文件夹PPNumberButton拖入到项目中, 导入头文件PPNumberButton.h开始使用.

2.CocoaPods安装:

first pod 'PPNumberButton' then pod install或pod install --no-repo-update`

如果发现pod search PPNumberButton 不是最新版本，在终端执行pod setup命令更新本地spec镜像缓存(时间可能有点长),重新搜索就OK了

Usage 使用方法

实例化方法

[[PPNumberButton alloc] init];:默认的frame为CGRectMake(0, 0, 110, 30) 或 [[PPNumberButton alloc] initWithFrame:frame];

或 [PPNumberButton numberButtonWithFrame:frame];: 类方法创建

1.自定义加减按钮文字标题

PPNumberButton *numberButton = [PPNumberButton numberButtonWithFrame:CGRectMake(100, 100, 110, 30)];
// 开启抖动动画
numberButton.shakeAnimation = YES;
// 设置最小值
numberButton.minValue = 2;
// 设置最大值
numberButton.maxValue = 10;
// 设置输入框中的字体大小
numberButton.inputFieldFont = 23;
numberButton.increaseTitle = @"＋";
numberButton.decreaseTitle = @"－";
    
numberButton.resultBlock = ^(NSString *num){
    NSLog(@"%@",num);
};
[self.view addSubview:numberButton];

2.边框状态

PPNumberButton *numberButton = [PPNumberButton numberButtonWithFrame:CGRectMake(100, 160, 150, 30)];
//设置边框颜色
numberButton.borderColor = [UIColor grayColor];
numberButton.increaseTitle = @"＋";
numberButton.decreaseTitle = @"－";
numberButton.resultBlock = ^(NSString *num){
    NSLog(@"%@",num);
}; 
[self.view addSubview:numberButton];

3.自定义加减按钮背景图片

PPNumberButton *numberButton = [PPNumberButton numberButtonWithFrame:CGRectMake(100, 220, 100, 30)];
numberButton.shakeAnimation = YES;
numberButton.increaseImage = [UIImage imageNamed:@"increase_taobao"];
numberButton.decreaseImage = [UIImage imageNamed:@"decrease_taobao"];
numberButton.resultBlock = ^(NSString *num){
    NSLog(@"%@",num);
};
[self.view addSubview:numberButton];

4.饿了么,美团外卖,百度外卖样式

PPNumberButton *numberButton = [PPNumberButton numberButtonWithFrame:CGRectMake(100, 280, 100, 30)];
// 初始化时隐藏减按钮
numberButton.decreaseHide = YES;
numberButton.increaseImage = [UIImage imageNamed:@"increase_meituan"];
numberButton.decreaseImage = [UIImage imageNamed:@"decrease_meituan"];
numberButton.resultBlock = ^(NSString *num){
    NSLog(@"%@",num);
};
[self.view addSubview:numberButton];

更多详细用法参见Demo

使用xib创建

在控制器界面拖入UIView控件,在右侧的设置栏中将class名修改为PPNumberButton,按回车就OK了 (注意:如果通过Cocopods导入, 使用XIB/SB创建按钮会显示不全,还可能会报错.但APP可以编译运行,这应该是Cocopods或Xcode的问题). 注意!如果有的同学将控件拖线到代码中,千万不要忘记在拖线的代码文件中导入 "PPNumberButton.h"头文件,否则会报错.

可以在IB界面设置相关属性

因为之前的项目中需要,在网上找了好多都不符合要求,干脆自己花了点时间撸了一个,现在分享出来,希望能帮到有需要的人。 如果你觉得不错,希望点个Star鼓励一下!

你的Star是我持续更新的动力!

CocoaPods更新日志

• 2018.02.08(tag:0.8.0): 
  1.新增步长stepValue;
  2.新增支持小数功能属性decimalNum.
  
• 2017.07.05(tag:0.7.0): 
  1.新增 longPressSpaceTime 属性,设置长按加减速度的快慢以及功能关闭;
  2.新增tableView列表Demo;
  3.其他代码小细节优化.
  
• 2016.12.22(tag:0.6.0): 
  1.将代理与Block回调的结果数字的类型 由 NSString -> NSInteger;
  2.代理与Block回调结果增加 increaseStatus(加运算状态);
  3.修复有时代理方法没有被实现导致Crash的Bug;
  4.修复减按钮为隐藏模式时,减运算到最小值没有回调的BUG.
								  
• 2016.12.19(tag:0.5.0):
  新增 editing(是否可以使用键盘输入)属性.
  
• 2016.12.09(tag:0.4.0): 
  1.修复当”减”按钮初始化为隐藏模式时, 对其赋值不了的BUG;
  2.优化代码,修复其他小问题.
  
• 2016.11.03(tag:0.3.0)--重大更新:
  1.增加饿了么/美团外卖/百度外卖样式;
  2.调整自定义属性设置接口.
  
• 2016.11.03(tag:0.2.0): 
  设置maxValue(最大值)与minValue(最小值)属性接口.
  
• 2016.09.14(tag:0.1.2);
  添加使用XIB创建时的实时显示
  
• 2016.09.12(tag:0.1.1): 
  小细节优化.
  
• 2016.09.03(tag:0.1.0):
  Pods初始化.

我的App <-> My APP

• PPHub：一个简洁漂亮的 GitHub iOS客户端 <-> A simple and beautiful GitHub iOS client
  

联系方式:

• Weibo : @jkpang-庞
• Email : [email protected]
• QQ群 : 323408051
• Blog : https://www.jkpang.cn

许可证

PPNumberButton 使用 MIT 许可证，详情见 LICENSE 文件。

ppnumberbutton's Issues

为什么我下载最新的 点击你的storyboard 会有报错

iOS11默认是0加减号点击无反应

我设置的minValue = 1， currentNumber = 1，但是在iOS11数字是0，而且点击加减号无反应，因新版xocde不好用，所以xocde的目前无法调试iOS11，烦请作者帮忙看下

自定义加减按钮的位置

希望能添加自定义按钮位置的功能，类似于这种

怎么样关闭长按?

我是改变数量就会调用网络请求, 长按的话, 一直频繁请求接口会导致崩溃.

您好，输入的文字没有进行合法性校验，可否加上？目前可以输入多个小数点、字符串、中文等等都可以输入

您好，输入的文字没有进行合法性校验，可否加上？目前可以输入多个小数点、字符串、中文等等都可以输入

有个建议，最小值时搞一个减号不能点的状态图

RT

CGFloat会出现数据失真的情况

建议换成NSDecimalNumber做数值加减，minValue 、maxValue、step使用String做接收。

您好！x7打不开怎么解决呢？

您好，我使用的是xcode7版本，并未升级xcode8，有什么办法在不升级xcode8的情况下成功运行您的工程呢？静待回复

我自定义了个键盘，支持输入小数点的。如何根据输入框的内容进行加减

如果数量为整数以1为单位加减，如果数量有小数以0.1为单位加减

你好,在使用时发现按照Demo做法创建的按钮加减操作时出现问题

点击一下加或减按钮后数字会一直增加或减小,再次点击相反的按钮,两个定时器就会相互作用,数字在左右跳动

存在内存泄漏的问题 出在_timer创建的位置 。

如果不想费事解决 github搜索HWWeakTimer 把NSTimer替换为HWWeakTimer 就可以解决

关于同时点击加号和减号数字自动减的bug

在原代码创建这两个button的时候加了如下两行代码，bug可解决
[_increaseBtn setExclusiveTouch:YES];
[_decreaseBtn setExclusiveTouch:YES];

当我需要定制如图这样的动画,给按钮加border的时候,bug就出来了.

当我需要定制如图这样的动画,给按钮加border的时候,bug就出来了
特别是当ppnumberButton.minValue <= 默认值 1 的时候, decreaseHide = YES的时候.
加号增加方法里的 逻辑上有漏洞.

所以我做了微调:
把你的源代码:

• (void)setMinValue:(NSInteger)minValue {
  _minValue = minValue;
  _textField.text = [NSString stringWithFormat:@"%ld",minValue];
  }

改成了

• (void)setMinValue:(NSInteger)minValue {
  _minValue = minValue;
  if (_decreaseHide) {
  _textField.text = [NSString stringWithFormat:@"%ld",minValue - 1];
  }else {
  _textField.text = [NSString stringWithFormat:@"%ld",minValue];
  }
  }

然后运行结果达到了我满意的状态,解决了+方法里的动画不执行的bug.

老问题依旧在，加减同时按住后，松开手，数字自己在动

老问题依旧在，加减同时按住后，松开手，数字自己在动

非0和非负数的情况下。能做成小数点的加减吗？

非0和非负数的情况下。能做成小数点的加减吗？

数字颜色属性支持

可不可以添加输入框文本数字颜色的属性支持，谢谢

zai cell

将加减的默认数值设置成自定义

将加减的默认数值设置成自定义，这样加减一次就不是每次都是加减1了

不支持自动布局吗？

不支持自定义布局吗？

不支持masonry布局。