☀️ 一款简约而不失强大的 ActionSheet，微信和微博都采取了极其类似的样式。
如果上图没打开，直接前往 Demo 图地址。
In me the tiger sniffs the rose.
心有猛虎，细嗅蔷薇。
欢迎访问我的博客：https://LeoDev.me
☀️ 一款简约而不失强大的 ActionSheet，微信和微博都采取了极其类似的样式。
-
iOS 7.0 +，Demo 需要 CocoaPods 环境运行。
-
格调高雅，风格百搭，怎么看怎么舒服。
-
高度自定义，可能需要自定义的基本都考虑到了。详见 LCActionSheet.h Properties 部分。
-
有代理，有 Block，可类方法，可实例方法，想怎样，就怎样。
-
代理、Block 非常完善，从 will 到 did 都有，详见 LCActionSheet.h Delegate & Block 部分。
-
支持统一配置 Config，作用于全局样式，告别冗余代码，更易维护，详见 V 2.7.0。
-
支持 iPad，支持横屏，支持竖屏，支持一会横屏一会竖屏，支持超长标题，理论上支持无数个按钮，统统支持。
-
注释完整，代码风格良好，善意满满，便于阅读源码，照顾强迫症，拓展更多功能请前往 PR。三个诸葛亮，顶个好工匠。
-
有骨气。就不改状态栏颜色，就是这么刚。
💬 告示
英文还不错时间又充裕的同学可以帮我翻译出 README 的英文版，我好往 CocoaControls 上扔啊~
可白文翻译，使用 Markdown 编辑更佳！义务的哦，如果翻译用心的话我个人请你喝杯咖啡 ☕️！
直接 PR 或者发我邮箱：[email protected] 都可！
-
两种导入方法：
-
方法一：CocoaPods：
pod 'LCActionSheet' -
方法二：直接把 LCActionSheet 文件夹（在 Demo 中）拖拽到你的项目中
-
-
在相应位置导入头文件：
#import "LCActionSheet.h"，遵守协议<LCActionSheetDelegate> -
调用下列任意方法即可：
- 默认样式，初始化 + Show，两行搞定
LCActionSheet *actionSheet = [LCActionSheet sheetWithTitle:@"Default LCActionSheet" delegate:self cancelButtonTitle:@"Cancel" otherButtonTitles:@"Button 1", @"Button 2", @"Button 3", nil]; [actionSheet show];
- 可自定义项，LCActionSheet.h 中有完整注释
LCActionSheet *actionSheet = [[LCActionSheet alloc] initWithTitle:nil delegate:self cancelButtonTitle:@"Cancel" otherButtonTitles:@"Button 1", @"Button 2", @"Button 3", @"Button 4", @"Button 5", nil]; actionSheet.title = @"This is a very very very very very very very very very very very very very very very very very very very very very very very very very very very long title~"; actionSheet.cancelButtonTitle = @"Close"; [actionSheet appendButtonTitles:@"Button 6", @"Button 7", nil]; actionSheet.titleColor = [UIColor orangeColor]; actionSheet.buttonColor = [UIColor greenColor]; actionSheet.titleFont = [UIFont boldSystemFontOfSize:15.0f]; actionSheet.buttonFont = [UIFont boldSystemFontOfSize:15.0f]; actionSheet.buttonHeight = 60.0f; actionSheet.scrolling = YES; actionSheet.visibleButtonCount = 3.6f; actionSheet.darkViewNoTaped = YES; actionSheet.unBlur = YES; actionSheet.blurEffectStyle = UIBlurEffectStyleLight; actionSheet.destructiveButtonIndexSet = [NSSet setWithObjects:@0, @2, nil]; actionSheet.destructiveButtonColor = [UIColor blueColor]; // V 2.7.0+ actionSheet.titleEdgeInsets = UIEdgeInsetsMake(10, 20, 30, 40); // V 2.7.1+ actionSheet.separatorColor = [UIColor orangeColor]; [actionSheet show];
- Block
LCActionSheet *actionSheet = [LCActionSheet sheetWithTitle:@"Block LCActionSheet" cancelButtonTitle:@"Cancel" clicked:^(LCActionSheet *actionSheet, NSInteger buttonIndex) { NSLog(@"clickedButtonAtIndex: %d", (int)buttonIndex); } otherButtonTitles:@"Button 1", @"Button 2", @"Button 3", @"Button 4", @"Button 5", @"Button 6", nil]; // actionSheet.blurEffectStyle = UIBlurEffectStyleLight; actionSheet.scrolling = YES; actionSheet.visibleButtonCount = 3.6f; actionSheet.willPresentBlock = ^(LCActionSheet *actionSheet) { NSLog(@"willPresentActionSheet"); }; actionSheet.didPresentBlock = ^(LCActionSheet *actionSheet) { NSLog(@"didPresentActionSheet"); }; actionSheet.willDismissBlock = ^(LCActionSheet *actionSheet, NSInteger buttonIndex) { NSLog(@"willDismissWithButtonIndex: %d", (int)buttonIndex); }; actionSheet.didDismissBlock = ^(LCActionSheet *actionSheet, NSInteger buttonIndex) { NSLog(@"didDismissWithButtonIndex: %d", (int)buttonIndex); }; [actionSheet show];
- Delegate，可选实现
#pragma mark - LCActionSheet Delegate - (void)actionSheet:(LCActionSheet *)actionSheet clickedButtonAtIndex:(NSInteger)buttonIndex { NSLog(@"clickedButtonAtIndex: %d", (int)buttonIndex); } - (void)willPresentActionSheet:(LCActionSheet *)actionSheet { NSLog(@"willPresentActionSheet"); } - (void)didPresentActionSheet:(LCActionSheet *)actionSheet { NSLog(@"didPresentActionSheet"); } - (void)actionSheet:(LCActionSheet *)actionSheet willDismissWithButtonIndex:(NSInteger)buttonIndex { NSLog(@"willDismissWithButtonIndex: %d", (int)buttonIndex); } - (void)actionSheet:(LCActionSheet *)actionSheet didDismissWithButtonIndex:(NSInteger)buttonIndex { NSLog(@"didDismissWithButtonIndex: %d", (int)buttonIndex); }
-
V 2.7.0 新增 LCActionSheetConfig 类，用来统一配置 LCActionSheet 的样式（参数）。LCActionSheetConfig 提供一个单例，你应该在首次初始化 LCActionSheet 之前配置该单例以统一配置 LCActionSheet，之后你还可以继续修改 LCActionSheet 实例的任意参数。示例代码如下：
// 统一配置 Config 作用于全局样式 LCActionSheetConfig *config = [LCActionSheetConfig shared]; config.title = @"Common Title"; config.cancelButtonTitle = @"Close"; config.titleColor = [UIColor orangeColor]; config.buttonColor = [UIColor greenColor]; config.titleFont = [UIFont boldSystemFontOfSize:15.0f]; config.buttonFont = [UIFont boldSystemFontOfSize:15.0f]; config.buttonHeight = 60.0f; config.scrolling = YES; config.visibleButtonCount = 3.6f; config.darkViewNoTaped = YES; config.unBlur = YES; config.blurEffectStyle = UIBlurEffectStyleDark; config.destructiveButtonIndexSet = [NSSet setWithObjects:@0, @2, nil]; config.destructiveButtonColor = [UIColor blueColor]; // 初始化 LCActionSheet, 与之前的初始化没有区别, 框架内会根据 Config 初始化 LCActionSheet *sheet = [[LCActionSheet alloc] initWithTitle:nil delegate:self cancelButtonTitle:@"Cancel" otherButtonTitles:@"Button 1", @"Button 2", @"Button 3", nil]; // 如果当前样式与全局样式不同, 可以继续修改参数... sheet.titleColor = [UIColor orangeColor]; [sheet show];
你可以在这里查看本框架的部分集成统计：CocoaPods 统计。
下表列举了集成本框架的部分项目：
| 名称 | 简介 |
|---|---|
| 见信 | 视频短信 |
| PrPr直播 | 二次元直播平台 |
| 德玛西亚 | 英雄联盟© 周边 App |
| 揽梦云签 | 考勤打卡 + 移动办公 |
| ... | ... |
注：本框架开源且不含任何信息上传功能代码，上表仅用作统计和效果参考，如果你的项目中使用了本框架并希望加入上表，请发邮件到 [email protected] 或者 新建一个 Issue 告诉我你的应用名称和应用链接，我会尽快添加 :)
-
新年快乐~
-
添加
separatorColor属性，默认值RGBA(170/255.0f, 170/255.0f, 170/255.0f, 0.5f)，#30 by Abel94：@interface LCActionSheet : UIView @property (nonatomic, strong) UIColor *separatorColor; @end
-
新增 LCActionSheetConfig 类，用来统一配置 LCActionSheet 的样式（参数），使用方式见 Usage。#29 by Abel94。
-
添加
titleEdgeInsets属性，默认值UIEdgeInsetsMake(15.0f, 15.0f, 15.0f, 15.0f)，#29 by Abel94：@interface LCActionSheet : UIView @property (nonatomic, assign) UIEdgeInsets titleEdgeInsets; @end
-
重写 LCActionSheet 初始化逻辑。
-
重写线条和阴影效果，采用加载颜色而不是加载图片的方式。
- 修复更换按钮颜色对取消按钮失效的 Bug。
- 优化标题为空时的效果。
-
修复取消按钮不显示时 UI 上的一个 Bug。另外你可以通过设置
cancelButtonTitle为nil或@""来不显示取消按钮，这是一个 Tip，并不是一个 Feature。。。 -
修正一些逻辑：
-
cancelButtonIndex始终返回0。 -
除取消按钮以外的按钮自上而下 Index 从 1 递增。也就是说，无论取消按钮是否显示，Index 0 始终会被取消按钮占有。
-
-
注： 因 CocoaPods 对 Xcode 8 的一些问题（Issue 5661、Issue 5843...），暂时无法推到 CocoaPods Repo，你需要在 Podfile 进行如下的修改，直接指向当前版本即可：
# 不需要了，作者借了个 Xcode 7 的电脑去更新了。。。 pod 'LCActionSheet' # , :git => 'https://github.com/iTofu/LCActionSheet.git'
* 修复一个影响用户体验的效果，详见：[Issue 25](https://github.com/iTofu/LCActionSheet/issues/25)。
* 完善剩下的部分注释，主要是 Block 部分。
### V 2.5.1 (2016.09.08)
* 修复一个更换字体失效的 Bug。
### V 2.5.0 (2016.09.05 ⚠️ 属性名变化)
* 添加 `cancenButtonIndex` 属性，始终返回 `0`：
```objc
@interface LCActionSheet : UIView
@property (nonatomic, assign, readonly) NSInteger cancelButtonIndex;
-
修改 Block 属性命名：
@property (nonatomic, copy) LCActionSheetClickedBlock clickedBlock; @property (nonatomic, copy) LCActionSheetWillPresentBlock willPresentBlock; @property (nonatomic, copy) LCActionSheetDidPresentBlock didPresentBlock; @property (nonatomic, copy) LCActionSheetWillDismissBlock willDismissBlock; @property (nonatomic, copy) LCActionSheetDidDismissBlock didDismissBlock; -> @property (nonatomic, copy) LCActionSheetClickedHandle clickedHandle; @property (nonatomic, copy) LCActionSheetWillPresentHandle willPresentHandle; @property (nonatomic, copy) LCActionSheetDidPresentHandle didPresentHandle; @property (nonatomic, copy) LCActionSheetWillDismissHandle willDismissHandle; @property (nonatomic, copy) LCActionSheetDidDismissHandle didDismissHandle;
-
修复设置
actionSheet.unBlur = YES;后背景透明的 Bug。 -
完善注释，移除无用类。
-
可以自定义 blurEffectStyle：
@property (nonatomic, assign) UIBlurEffectStyle blurEffectStyle;
- 静态渲染模糊改为模糊蒙板。
-
重新实现 V 1.x 的方法，允许使用数组而不必须是多参数来设置按钮标题：
#pragma mark Delegate + (instancetype)sheetWithTitle:(NSString *)title delegate:(id<LCActionSheetDelegate>)delegate cancelButtonTitle:(NSString *)cancelButtonTitle otherButtonTitleArray:(NSArray *)otherButtonTitleArray; - (instancetype)initWithTitle:(NSString *)title delegate:(id<LCActionSheetDelegate>)delegate cancelButtonTitle:(NSString *)cancelButtonTitle otherButtonTitleArray:(NSArray *)otherButtonTitleArray; #pragma mark Block + (instancetype)sheetWithTitle:(NSString *)title cancelButtonTitle:(NSString *)cancelButtonTitle clicked:(LCActionSheetClickedBlock)clickedBlock otherButtonTitleArray:(NSArray *)otherButtonTitleArray; - (instancetype)initWithTitle:(NSString *)title cancelButtonTitle:(NSString *)cancelButtonTitle clicked:(LCActionSheetClickedBlock)clickedBlock otherButtonTitleArray:(NSArray *)otherButtonTitleArray;
-
优化一些 UI 效果，主要是高亮状态的效果。
- 添加高斯模糊效果（可选），Issue 19 by guanzhendong。
- 完善部分注释，注明需要注明的属性的默认值。
-
destructiveButtonColor // 警示按钮颜色 -
修改一个属性命名：
// 与 UIActionSheet 命名保持一致，便于顺手敲出 // V 2.1.0 给予 redButtonIndexSet 过期警告，下一版本将会移除该属性 redButtonIndexSet -> destructiveButtonIndexSet
- 更新 CocoaPods 源地址。
-
合并 PR by apache2046，致谢！
Swift bug fixed
mainBundle 这种方法无法在将 LCActionSheet 作为 Framework 时正确找到资源包路径
-
合并 PR by zachgenius，致谢！
增加了一些功能实现，如增加自定义添加按钮的方法，增加按钮本地化，增加自定义按钮颜色，并且优化逻辑。
-
V 1.1.2 被怪物吃掉了！👹
- 标题支持最多两行。两行时会适当调整标题的背景高度。
-
要 Block？满足你！
-
优化逻辑：创建 ActionSheet 时，不再添加到 window 上。
-
添加对 CocoaPods 的支持：
pod 'LCActionSheet'
-
修复：新添加的 _backWindow 在某些情况下导致界面无反应的BUG。——by kuanglijun312
-
修复：当 StatusBarStyle 为 UIStatusBarStyleLightContent 时，背景不会遮挡 statusBar 的问题。——by 陈威
-
增加了类方法，可以通过类方法实例化 actionSheet。
-
完善部分注释。
-
LCActionSheet 添加到 KeyWindow 上，已适配横屏。
-
可自定义 title、buttons、destructiveButtons、cancelButton、titleColor、titleFont、buttonColor、buttonFont、canScrolling 等等，详见 LCActionSheet.h。
-
点击的 buttonIndex 按 UIAlertView 的逻辑来即可，若有取消按钮则取消按钮为 0，其他从上至下递增。
-
scrolling 属性控制按钮过多时，是否可以滚动，默认 NO，不可滚动。visibleButtonCount 属性控制可见的按钮个数，可以是小数，必须先设置 scrolling = YES 才生效。tableView 的 scrollsToTop 属性依然可用，可点击状态栏快速滚回顶部。
-
有疑问或建议请 New Issue，谢谢 :)
-
Mail:
echo ZGV2dGlwQDE2My5jb20K | base64 -D -
Blog: http://LeoDev.me
-
如果你觉得我的项目对你有所帮助，想要进行捐赠的话，非常感谢你的情怀~
本项目采用 MIT license 开源，你可以利用采用该协议的代码做任何事情，只需要继续继承 MIT 协议即可。