https://github.com/meterwhite/sdmask
A perfect iOS mask view that help you to present custom view and guid page.User dont need to care about animations and events.
https://github.com/meterwhite/sdmask
actionsheet-hud actionsheet-mask alert-hud alert-mask cover-view guid-controller hud ios-cover ios-guid ios-mask maskview
Last synced: 8 months ago
JSON representation
A perfect iOS mask view that help you to present custom view and guid page.User dont need to care about animations and events.
- Host: GitHub
- URL: https://github.com/meterwhite/sdmask
- Owner: Meterwhite
- License: mit
- Created: 2016-01-29T06:59:00.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-09-05T16:15:42.000Z (almost 2 years ago)
- Last Synced: 2025-10-23T09:59:46.454Z (8 months ago)
- Topics: actionsheet-hud, actionsheet-mask, alert-hud, alert-mask, cover-view, guid-controller, hud, ios-cover, ios-guid, ios-mask, maskview
- Language: Objective-C
- Homepage:
- Size: 5.32 MB
- Stars: 54
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SDMask
> [修改Cocoapods源代码!](https://github.com/Meterwhite/ObjcHook4pod)
>
> [新的ObjC语言效率工具！](https://github.com/Meterwhite/Objc2020)
>
> [本地化解决方案](https://github.com/Meterwhite/SDLocalize)
## 介绍 Introduce
* A perfect iOS mask view that help you to present custom view.User dont need to care about animations and events.
* Skir的（SD）iOS蒙版蒙层遮罩.弹出自定义视图，用户不再关心动画和点击事件。
* 点赞富一生.
* Good luck for one start .
## Import
- Drag floder `SDMask` to your project.
```objc
#import "SDMask.h"
```
## CocoaPods
```
pod 'SDMask'
```
## 常用形式 High frequency code.(推荐 recommended)
```objc
[SDMaskUserView(customAlertView) sdm_showAlertUsingBlock:^(SDMask* _Nonnull mask) {
/// You can bind control events to SDMask
[mask bindEventForControls:@[mask.userView.OKButton]]
[mask bindEventForCancelControl:mask.userView.CancelButton];
[mask bindingEventsUsingBlock:^(SDMaskBindingEvent * event) {
if(event.index == 0){
/// okButton...
}
}];
[mask userViewDidLoad:^(SDMaskModel * model) {
model.setAutolayoutValueForKey(@(0), @"bottom").
setAutolayoutValueForKey(@(15), @"left").
setAutolayoutValueForKey(@(15), @"right").
setAutolayoutValueForKey(@(350), @"height");
}];
... ...
}];
```
## 分步处理复杂的业务 Step-by-step processing of complex business.
```objc
SDMask* mask = SDAlertMaskWith(currentController, userView);
[mask userViewDidLoad:^(SDMaskModel * model) {
model.
setAutolayoutValueForKey(@(0), @"bottom").
setAutolayoutValueForKey(@(15), @"left").
setAutolayoutValueForKey(@(15), @"right").
setAutolayoutValueForKey(@(350), @"height");
}];
[mask bindEventForControls:@[Button1, Button2, [Button3 sdm_withBindingKey:@"MyKey"], ...]];
[mask bindEventForCancelControl:CancelButton];
[mask bindingEventFor:Button1 usingBlock:^(SDMaskBindingEvent * event) {
/// ...
}];
[mask bindingEventFor:@"MyKey" usingBlock:^(SDMaskBindingEvent * event) {
/// ...
}];
[mask show];
```
## 引导控制器 SDMaskGuidController
### 在一个XIB文件中设置多个页面的约束进行适配，可以适应90%的设计需求。Set multiple guid pages in one controller XIB file ! By changing the constraints in XIB to adapt the device, this solution can address 90% of the design needs.
```objc
[[[MySDMaskGuidController new] userViewDidLoad:^(SDMaskModel * _Nonnull model) {
/// Set the same color as user view to background.
[model setBackgroundColor:[UIColor colorWithWhite:0 alpha:0.6]];
}] show];
```
## 链式编程 Chain programming
- 链式编程涵盖了大多数方法 Chained programming covers most methods
```objc
[...[[[mask bindEventForControls:@[okButton]] bindEventForCancelControl:cancelButton] bindingEventsUsingBlock:^(SDMaskBindingEvent* event) {
}]... show];
```
## Use autolayout
### 自动布局的两种方式 Tow ways to use autolayout.
- a. 框架提供 Use the methods provided by the SDMask to use autolayout.
```objc
[mask userViewDidLoad:^(SDMaskModel * model) {
model.
setAutolayoutValueForKey(@(0), @"bottom").
setAutolayoutValueForKey(@(15), @"left").
setAutolayoutValueForKey(@(15), @"right").
setAutolayoutValueForKey(@(350), @"height");
}];
```
- b. 三方或手动布局 Autolayout by youself. Like 'masonry'
```objc
[mask userViewDidLoad:^(SDMaskModel * model) {
[model.userView mas_makeConstraints:^(MASConstraintMaker *make) {
make.center.equalTo(model.containerView);
make.left.equalTo(model.containerView.mas_left).offset(20);
make.right.equalTo(model.containerView.mas_right).offset(-20);
}];
}];
```
## 自定义动画 Use custom animations
- Framelayout
```objc
[[[[[mask userViewPresentationWillAnimate:^(SDMaskModel * model) {
userView.frame = frameA;
}] userViewPresentationDoAnimations:^(SDMaskModel * model) {
userView.frame = frameB;
}] userViewDismissionWillAnimate:^(SDMaskModel * model) {
/// ...
}] userViewDismissionDoAnimations:^(SDMaskModel * model) {
userView.frame = frameA;
}] disableSystemAnimation];
```
- Autolayout
```objc
[[[[[mask userViewPresentationWillAnimate:^(SDMaskModel * model) {
userView.bottonConstraint = A;
//[self.view setNeedsLayout];
//[self.view layoutIfNeeded];
}] userViewPresentationDoAnimations:^(SDMaskModel * model) {
userView.bottonConstraint = B;
[self.view setNeedsLayout];
[self.view layoutIfNeeded];
}] userViewDismissionWillAnimate:^(SDMaskModel * model) {
/// ...
}] userViewDismissionDoAnimations:^(SDMaskModel * model) {
userView.bottonConstraint = A;
[self.view setNeedsLayout];
[self.view layoutIfNeeded];
}] disableSystemAnimation];
```
## 使用泛型 Use generics
* 泛型宏定义的使用可以避免在外部声明弱引用 The use of macro definitions for generic functions can avoid declaring weak references externally
## Email
- 项目合作：meterwhite@outlook.com