- GitHub源码: RadioButton
- star: 200+
⭐️⭐️⭐️
以下内容来源于官方源码、 README 文档、测试 Demo或个人使用总结 ！
Radio Button for iOS——iOS单选按钮
README.md文档描述
继承自 UIButton 的一个非常简单的类，扩展了标准的 UIButton 的功能。
可以为每个按钮配置默认和选中状态。
[图片上传失败...(image-49831d-1587702980658)]
非常容易使用
它不需要任何 central manager。 只需在Interface Builder中直接链接按钮：
[图片上传失败...(image-9a7c7a-1587702980658)]
或者，使用单行代码对按钮进行分组：
radio1.groupButtons = @[radio1, radio2, radio3];
设置任意按钮为选中状态，同一组中的所有其他按钮将自动取消选中状态：
radio2.selected = YES; // radio1 and radio3 become deselected
组中的任何一个按钮都知道哪一个被选中了：
RadioButton* r1 = radio1.selectedButton;
RadioButton* r2 = radio2.selectedButton;
RadioButton* r3 = radio3.selectedButton;
NSAssert (r1==r2 && r2==r3, @"Must be equal");
另一个通过标签选择按钮的好方法：
[radio1 setSelectedWithTag:kTagRadio3];
资源
sample.zip - Sample app
radio-res-ios.zip - Radio Button images used in the sample
许可
RadioButton 基于 MIT许可协议，—你可以基于你的意愿fork、覆盖和使用
实践使用
参照官方Demo，学习使用 RadioButton。
首先需要导入RadioButton.h 和 RadioButton.m 文件；
其次还需要两张图片用于显示按钮选中（check）和未选中（unchecked）状态。
1. 一组中有三个单选按钮
[图片上传失败...(image-b0c222-1587702980658)]
- 首先在Interface Builder界面中拖入3个 UIButton 控件、1个 UILabel 控件；
- 选中第一个 UIButton 控件，修改 Identity Inspector 工具栏中的class属性为：Radio Button；
- 还是在选中第一个 UIButton 控件下，切换到 Attributes Inspector 工具栏中修改相关属性如下：
其中你需要分开设置 Button按钮在不同状态下显示的图片（蓝框所示）：
- **Default **默认状态下设置的 Image 是：unchecked.png;
- Selected选中状态下设置的 Image 是：checked.png;
另外勾选设置第一个 Button 按钮的初始化状态是默认选中的（绿框所示）。
-
剩下两个 Button 按钮也相同设置，需要区分设置的是Title标题、另外两个按钮都不用勾选默认选中状态，设置完成后应该是这样的：
设置群组，在 Radio Button1 上鼠标右击，找到 groupButtons 属性，长按➕连接到 Radio Button2 ，再如法炮制，将 Radio Button2 的 **groupButtons **连接到 Radio Button3；
修改 UILabel 控件的默认Text属性显示为：Radio Button1，因为Radio Button1是默认选中的，所以默认文本也应该显示这个：
-
关联到代码：
- 在viewController.h 文件中先声明Radio Button类;
@class RadioButton;- 关联以上几个控件属性；
@property (strong, nonatomic) IBOutlet RadioButton *radioButton1; @property (strong, nonatomic) IBOutlet RadioButton *radioButton2; @property (strong, nonatomic) IBOutlet RadioButton *radioButton3; @property (strong, nonatomic) IBOutlet UILabel *statusLabel;- 在 viewController.m 文件中导入
import "RadioButton.h"
-
将3个Radio Button按钮同时关联到一个方法上：
- (IBAction)onRadioBtn:(RadioButton *)sender { _statusLabel.text = [NSString stringWithFormat:@"%@",sender.titleLabel.text]; } 构建运行。
2.一组中有两个按钮
该例与1的类似，就不详细说了，只是【切换】是一个标准的 UIButton 按钮，该按钮关联的方法如下：
- (IBAction)radioBtnInvert:(UIButton *)sender {
_man.selected = !_man.selected;
}
3.代码创建方法
点击按钮创建一个包含三个按钮的群组
代码方法：
- (IBAction)createMoreBtn:(UIButton *)sender {
[sender setHidden:YES];
NSMutableArray* buttonsArray = [NSMutableArray arrayWithCapacity:3];
CGRect btnRect = CGRectMake(25, 320, 100, 30);
for (NSString* optionTitle in @[@"Red", @"Green", @"Blue"]) {
RadioButton* btn = [[RadioButton alloc] initWithFrame:btnRect];
[btn addTarget:self action:@selector(onRadioButtonValueChanged:) forControlEvents:UIControlEventValueChanged];
btnRect.origin.y += 40;
[btn setTitle:optionTitle forState:UIControlStateNormal];
[btn setTitleColor:[UIColor darkGrayColor] forState:UIControlStateNormal];
btn.titleLabel.font = [UIFont boldSystemFontOfSize:17];
[btn setImage:[UIImage imageNamed:@"unchecked.png"] forState:UIControlStateNormal];
[btn setImage:[UIImage imageNamed:@"checked.png"] forState:UIControlStateSelected];
btn.contentHorizontalAlignment = UIControlContentHorizontalAlignmentLeft;
btn.titleEdgeInsets = UIEdgeInsetsMake(0, 6, 0, 0);
[self.view addSubview:btn];
[buttonsArray addObject:btn];
}
[buttonsArray[0] setGroupButtons:buttonsArray]; // 把按钮放进群组中
[buttonsArray[0] setSelected:YES]; // 初始化第一个按钮为选中状态
}
