This commit is contained in:
2025-11-06 13:18:27 +08:00
parent abf32e8457
commit d7874829d9
48 changed files with 6952 additions and 2389 deletions

19
Pods/LSTPopView/LICENSE generated Normal file
View File

@@ -0,0 +1,19 @@
Copyright (c) 2020 490790096@qq.com <LoSenTrad@163.com>
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

View File

@@ -0,0 +1,231 @@
//
// LSTPopView.h
// LoSenTrad
//
// Created by LoSenTrad on 2020/2/22.
//
/**
联系方式---> QQ群: 1045568246 微信: a_LSTKit , 邮箱: losentrad@163.com 欢迎反馈建议和问题
博客地址 如果觉得好用 伸出你的小指头 点Star 点赞 点收藏! 就是给予我最大的支持!
github: https://github.com/LoSenTrad/LSTPopView
简书: https://www.jianshu.com/p/8023a85dc2a2
cocoachina: http://www.cocoachina.com/articles/899060
*/
#import <UIKit/UIKit.h>
#import "LSTPopViewProtocol.h"
#import "UIView+LSTPV.h"
#define LSTPopViewWK(object) __weak typeof(object) wk_##object = object;
#define LSTPopViewSS(object) __strong typeof(object) object = weak##object;
NS_ASSUME_NONNULL_BEGIN
@interface LSTPopView : UIView
/** 代理 支持多代理 */
@property (nonatomic, weak) id<LSTPopViewProtocol> _Nullable delegate;
/** 标识 默认为空 */
@property (nonatomic, copy) NSString *_Nullable identifier;
/** 弹窗容器 */
@property (nonatomic, readonly) UIView *parentView;
/** 自定义view */
@property (nonatomic, readonly) UIView *currCustomView;
/** 弹窗位置 默认LSTHemStyleCenter */
@property (nonatomic, assign) LSTHemStyle hemStyle;
/** 显示时动画弹窗样式 默认LSTPopStyleNO */
@property (nonatomic, assign) LSTPopStyle popStyle;
/** 移除时动画弹窗样式 默认LSTDismissStyleNO */
@property (nonatomic, assign) LSTDismissStyle dismissStyle;
/** 显示时动画时长,> 0。不设置则使用默认的动画时长 设置成LSTPopStyleNO, 该属性无效 */
@property (nonatomic, assign) NSTimeInterval popDuration;
/** 隐藏时动画时长,>0。不设置则使用默认的动画时长 设置成LSTDismissStyleNO, 该属性无效 */
@property (nonatomic, assign) NSTimeInterval dismissDuration;
/** 弹窗水平方向(X)偏移量校准 默认0 */
@property (nonatomic, assign) CGFloat adjustX;
/** 弹窗垂直方向(Y)偏移量校准 默认0 */
@property (nonatomic, assign) CGFloat adjustY;
/** 背景颜色 默认rgb(0,0,0) 透明度0.3 */
@property (nullable,nonatomic,strong) UIColor *bgColor;
/** 显示时背景的透明度,取值(0.0~1.0)默认为0.3 */
@property (nonatomic, assign) CGFloat bgAlpha;
/** 是否隐藏背景 默认NO */
@property (nonatomic, assign) BOOL isHideBg;
/** 显示时点击背景是否移除弹窗默认为NO。 */
@property (nonatomic, assign) BOOL isClickBgDismiss;
/** 是否监听屏幕旋转默认为YES */
@property (nonatomic, assign) BOOL isObserverScreenRotation;
/** 是否支持点击回馈 默认NO (暂时关闭) */
@property (nonatomic, assign) BOOL isClickFeedback;
/** 是否规避键盘 默认YES */
@property (nonatomic, assign) BOOL isAvoidKeyboard;
/** 弹窗和键盘的距离 默认10 */
@property (nonatomic, assign) CGFloat avoidKeyboardSpace;
/** 显示多长时间 默认0 不会消失 */
@property (nonatomic, assign) NSTimeInterval showTime;
/** 自定view圆角方向设置 默认UIRectCornerAllCorners 当cornerRadius>0时生效*/
@property (nonatomic, assign) UIRectCorner rectCorners;
/** 自定义view圆角大小 */
@property (nonatomic, assign) CGFloat cornerRadius;
/** 弹出震动反馈 默认NO iOS10+ 系统才有此效果 */
@property (nonatomic, assign) BOOL isImpactFeedback;
//************ 群组相关属性 ****************
/** 群组标识 统一给弹窗编队 方便独立管理 默认为nil,统一全局处理 */
@property (nullable,nonatomic,strong) NSString *groupId;
/** 是否堆叠 默认NO 如果是YES priority优先级不生效*/
@property (nonatomic,assign) BOOL isStack;
/** 单显示 默认NO 只会显示优先级最高的popView */
@property (nonatomic, assign) BOOL isSingle;
/** 优先级 范围0~1000 (默认0,遵循先进先出) isStack和isSingle为NO的时候生效 */
@property (nonatomic, assign) CGFloat priority;
//****************************************
//************ 拖拽手势相关属性 ****************
/** 拖拽方向 默认 不可拖拽 */
@property (nonatomic, assign) LSTDragStyle dragStyle;
/** X轴或者Y轴拖拽移除临界距离 范围(0 ~ +∞) 默认0 不拖拽移除 基使用于dragStyle */
@property (nonatomic, assign) CGFloat dragDistance;
/** 拖拽移除动画类型 默认同dismissStyle */
@property (nonatomic, assign) LSTDismissStyle dragDismissStyle;
/** 拖拽消失动画时间 默认同 dismissDuration */
@property (nonatomic, assign) NSTimeInterval dragDismissDuration;
/** 拖拽复原动画时间 默认0.25s */
@property (nonatomic, assign) NSTimeInterval dragReboundTime;
/** 轻扫方向 默认 不可轻扫 前提开启dragStyle */
@property (nonatomic, assign) LSTSweepStyle sweepStyle;
/** 轻扫速率 控制轻扫移除 默认1000 基于使用sweepStyle */
@property (nonatomic, assign) CGFloat swipeVelocity;
/** 轻扫移除的动画 默认LSTSweepDismissStyleVelocity */
@property (nonatomic, assign) LSTSweepDismissStyle sweepDismissStyle;
//@property (nonatomic, strong) NSArray *xDragDistances;//待计划
//@property (nonatomic, strong) NSArray *yDragDistances;//待计划
//****************************************
/** 点击背景 */
@property (nullable, nonatomic, copy) void(^bgClickBlock)(void);
/** 长按背景 */
@property (nullable, nonatomic, copy) void(^bgLongPressBlock)(void);
/** 弹窗pan手势偏移量 */
@property (nullable, nonatomic, copy) void(^panOffsetBlock)(CGPoint offset);
//以下键盘弹出/收起 第三方键盘会多次回调(百度,搜狗测试得出), 原生键盘回调一次
/** 键盘将要弹出 */
@property (nullable, nonatomic, copy) void(^keyboardWillShowBlock)(void);
/** 键盘弹出完毕 */
@property (nullable, nonatomic, copy) void(^keyboardDidShowBlock)(void);
/** 键盘frame将要改变 */
@property (nullable, nonatomic, copy) void(^keyboardFrameWillChangeBlock)(CGRect beginFrame,CGRect endFrame,CGFloat duration);
/** 键盘frame改变完毕 */
@property (nullable, nonatomic, copy) void(^keyboardFrameDidChangeBlock)(CGRect beginFrame,CGRect endFrame,CGFloat duration);
/** 键盘将要收起 */
@property (nullable, nonatomic, copy) void(^keyboardWillHideBlock)(void);
/** 键盘收起完毕 */
@property (nullable, nonatomic, copy) void(^keyboardDidHideBlock)(void);
//************ 生命周期回调(Block) ************
/** 将要显示 回调 */
@property (nullable, nonatomic, copy) void(^popViewWillPopBlock)(void);
/** 已经显示完毕 回调 */
@property (nullable, nonatomic, copy) void(^popViewDidPopBlock)(void);
/** 将要开始移除 回调 */
@property (nullable, nonatomic, copy) void(^popViewWillDismissBlock)(void);
/** 已经移除完毕 回调 */
@property (nullable, nonatomic, copy) void(^popViewDidDismissBlock)(void);
/** 倒计时 回调 */
@property (nullable, nonatomic, copy) void(^popViewCountDownBlock)(LSTPopView *popView,NSTimeInterval timeInterval);
//********************************************
/*
以下是构建方法
customView: 已定义view
popStyle: 弹出动画
dismissStyle: 移除动画
parentView: 弹窗父容器
*/
+ (nullable instancetype)initWithCustomView:(UIView *_Nonnull)customView;
+ (nullable instancetype)initWithCustomView:(UIView *)customView
popStyle:(LSTPopStyle)popStyle
dismissStyle:(LSTDismissStyle)dismissStyle;
+ (nullable instancetype)initWithCustomView:(UIView *)customView
parentView:(UIView *_Nullable)parentView
popStyle:(LSTPopStyle)popStyle
dismissStyle:(LSTDismissStyle)dismissStyle;
/*
以下是弹出方法
popStyle: 弹出动画 优先级大于全局的popStyle 局部起作用
duration: 弹出时间 优先级大于全局的popDuration 局部起作用
*/
- (void)pop;
- (void)popWithStyle:(LSTPopStyle)popStyle;
- (void)popWithDuration:(NSTimeInterval)duration;
- (void)popWithStyle:(LSTPopStyle)popStyle duration:(NSTimeInterval)duration;
/*
以下是弹出方法
dismissStyle: 弹出动画 优先级大于全局的dismissStyle 局部起作用
duration: 弹出时间 优先级大于全局的dismissDuration 局部起作用
*/
- (void)dismiss;
- (void)dismissWithStyle:(LSTDismissStyle)dismissStyle;
- (void)dismissWithDuration:(NSTimeInterval)duration;
- (void)dismissWithStyle:(LSTDismissStyle)dismissStyle duration:(NSTimeInterval)duration;
/** 删除指定代理 */
- (void)removeForDelegate:(id<LSTPopViewProtocol>)delegate;
/** 删除代理池 删除所有代理 */
- (void)removeAllDelegate;
#pragma mark - ***** 以下是 窗口管理api *****
/** 获取全局(整个app内)所有popView */
+ (NSArray *)getAllPopView;
/** 获取当前页面所有popView */
+ (NSArray *)getAllPopViewForParentView:(UIView *)parentView;
/** 获取当前页面指定编队的所有popView */
+ (NSArray *)getAllPopViewForPopView:(UIView *)popView;
/**
读取popView (有可能会跨编队读取弹窗)
建议使用getPopViewForGroupId:forkey: 方法进行精确读取
*/
+ (LSTPopView *)getPopViewForKey:(NSString *)key;
/** 移除popView */
+ (void)removePopView:(LSTPopView *)popView;
/**
移除popView 通过唯一key (有可能会跨编队误删弹窗)
建议使用removePopViewForGroupId:forkey: 方法进行精确删除
*/
+ (void)removePopViewForKey:(NSString *)key;
/** 移除所有popView */
+ (void)removeAllPopView;
/** 移除 最后一个弹出的 popView */
+ (void)removeLastPopView;
/** 开启调试view 建议设置成 线上隐藏 测试打开 */
+ (void)setLogStyle:(LSTPopViewLogStyle)logStyle;
@end
NS_ASSUME_NONNULL_END

File diff suppressed because it is too large Load Diff

View File

@@ -0,0 +1,143 @@
//
// LSTPopViewProtocol.h
// LSTCategory
//
// Created by LoSenTrad on 2020/5/30.
//
#import <Foundation/Foundation.h>
@class LSTPopView;
#ifdef DEBUG
#define LSTPVLog(format, ...) printf("class: <%p %s:(第%d行) > method: %s \n%s\n", self, [[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], __LINE__, __PRETTY_FUNCTION__, [[NSString stringWithFormat:(format), ##__VA_ARGS__] UTF8String] )
#else
#define LSTPVLog(format, ...)
#endif
/** 调试日志类型 */
typedef NS_ENUM(NSInteger, LSTPopViewLogStyle) {
LSTPopViewLogStyleNO = 0, // 关闭调试信息(窗口和控制台日志输出)
LSTPopViewLogStyleWindow, // 开启左上角小窗
LSTPopViewLogStyleConsole, // 开启控制台日志输出
LSTPopViewLogStyleALL // 开启小窗和控制台日志
};
/** 显示动画样式 */
typedef NS_ENUM(NSInteger, LSTPopStyle) {
LSTPopStyleFade = 0, // 默认 渐变出现
LSTPopStyleNO, // 无动画
LSTPopStyleScale, // 缩放 先放大 后恢复至原大小
LSTPopStyleSmoothFromTop, // 顶部 平滑淡入动画
LSTPopStyleSmoothFromLeft, // 左侧 平滑淡入动画
LSTPopStyleSmoothFromBottom, // 底部 平滑淡入动画
LSTPopStyleSmoothFromRight, // 右侧 平滑淡入动画
LSTPopStyleSpringFromTop, // 顶部 平滑淡入动画 带弹簧
LSTPopStyleSpringFromLeft, // 左侧 平滑淡入动画 带弹簧
LSTPopStyleSpringFromBottom, // 底部 平滑淡入动画 带弹簧
LSTPopStyleSpringFromRight, // 右侧 平滑淡入动画 带弹簧
LSTPopStyleCardDropFromLeft, // 顶部左侧 掉落动画
LSTPopStyleCardDropFromRight, // 顶部右侧 掉落动画
};
/** 消失动画样式 */
typedef NS_ENUM(NSInteger, LSTDismissStyle) {
LSTDismissStyleFade = 0, // 默认 渐变消失
LSTDismissStyleNO, // 无动画
LSTDismissStyleScale, // 缩放
LSTDismissStyleSmoothToTop, // 顶部 平滑淡出动画
LSTDismissStyleSmoothToLeft, // 左侧 平滑淡出动画
LSTDismissStyleSmoothToBottom, // 底部 平滑淡出动画
LSTDismissStyleSmoothToRight, // 右侧 平滑淡出动画
LSTDismissStyleCardDropToLeft, // 卡片从中间往左侧掉落
LSTDismissStyleCardDropToRight, // 卡片从中间往右侧掉落
LSTDismissStyleCardDropToTop, // 卡片从中间往顶部移动消失
};
/** 主动动画样式(开发中) */
typedef NS_ENUM(NSInteger, LSTActivityStyle) {
LSTActivityStyleNO = 0, /// 无动画
LSTActivityStyleScale, /// 缩放
LSTActivityStyleShake, /// 抖动
};
/** 弹窗位置 */
typedef NS_ENUM(NSInteger, LSTHemStyle) {
LSTHemStyleCenter = 0, //居中
LSTHemStyleTop, //贴顶
LSTHemStyleLeft, //贴左
LSTHemStyleBottom, //贴底
LSTHemStyleRight, //贴右
LSTHemStyleTopLeft, //贴顶和左
LSTHemStyleBottomLeft, //贴底和左
LSTHemStyleBottomRight, //贴底和右
LSTHemStyleTopRight //贴顶和右
};
/** 拖拽方向 */
typedef NS_ENUM(NSInteger, LSTDragStyle) {
LSTDragStyleNO = 0, //默认 不能拖拽窗口
LSTDragStyleX_Positive = 1<<0, //X轴正方向拖拽
LSTDragStyleX_Negative = 1<<1, //X轴负方向拖拽
LSTDragStyleY_Positive = 1<<2, //Y轴正方向拖拽
LSTDragStyleY_Negative = 1<<3, //Y轴负方向拖拽
LSTDragStyleX = (LSTDragStyleX_Positive|LSTDragStyleX_Negative), //X轴方向拖拽
LSTDragStyleY = (LSTDragStyleY_Positive|LSTDragStyleY_Negative), //Y轴方向拖拽
LSTDragStyleAll = (LSTDragStyleX|LSTDragStyleY) //全向拖拽
};
///** 可轻扫消失的方向 */
typedef NS_ENUM(NSInteger, LSTSweepStyle) {
LSTSweepStyleNO = 0, //默认 不能拖拽窗口
LSTSweepStyleX_Positive = 1<<0, //X轴正方向拖拽
LSTSweepStyleX_Negative = 1<<1, //X轴负方向拖拽
LSTSweepStyleY_Positive = 1<<2, //Y轴正方向拖拽
LSTSweepStyleY_Negative = 1<<3, //Y轴负方向拖拽
LSTSweepStyleX = (LSTSweepStyleX_Positive|LSTSweepStyleX_Negative), //X轴方向拖拽
LSTSweepStyleY = (LSTSweepStyleY_Positive|LSTSweepStyleY_Negative), //Y轴方向拖拽
LSTSweepStyleALL = (LSTSweepStyleX|LSTSweepStyleY) //全向轻扫
};
/**
可轻扫消失动画类型 对单向横扫 设置有效
LSTSweepDismissStyleSmooth: 自动适应选择以下其一
LSTDismissStyleSmoothToTop,
LSTDismissStyleSmoothToLeft,
LSTDismissStyleSmoothToBottom ,
LSTDismissStyleSmoothToRight
*/
typedef NS_ENUM(NSInteger, LSTSweepDismissStyle) {
LSTSweepDismissStyleVelocity = 0, //默认加速度 移除
LSTSweepDismissStyleSmooth = 1 //平顺移除
};
NS_ASSUME_NONNULL_BEGIN
@protocol LSTPopViewProtocol <NSObject>
/** 点击弹窗 回调 */
- (void)lst_PopViewBgClickForPopView:(LSTPopView *)popView;
/** 长按弹窗 回调 */
- (void)lst_PopViewBgLongPressForPopView:(LSTPopView *)popView;
// ****** 生命周期 ******
/** 将要显示 */
- (void)lst_PopViewWillPopForPopView:(LSTPopView *)popView;
/** 已经显示完毕 */
- (void)lst_PopViewDidPopForPopView:(LSTPopView *)popView;
/** 倒计时进行中 timeInterval:时长 */
- (void)lst_PopViewCountDownForPopView:(LSTPopView *)popView forCountDown:(NSTimeInterval)timeInterval;
/** 倒计时倒计时完成 */
- (void)lst_PopViewCountDownFinishForPopView:(LSTPopView *)popView;
/** 将要开始移除 */
- (void)lst_PopViewWillDismissForPopView:(LSTPopView *)popView;
/** 已经移除完毕 */
- (void)lst_PopViewDidDismissForPopView:(LSTPopView *)popView;
//***********************
@end
NS_ASSUME_NONNULL_END

View File

@@ -0,0 +1,49 @@
//
// UIView+LSTPV.h
// LSTPopView
//
// Created by LoSenTrad on 2020/11/30.
//
#import <UIKit/UIKit.h>
NS_ASSUME_NONNULL_BEGIN
@interface UIView (LSTPV)
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_X;
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_Y;
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_Width;
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_Height;
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_CenterX;
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_CenterY;
/** 获取/设置view的x坐标 */
@property (nonatomic, assign) CGFloat pv_Top;
/** 获取/设置view的左边坐标 */
@property (nonatomic, assign) CGFloat pv_Left;
/** 获取/设置view的底部坐标Y */
@property (nonatomic, assign) CGFloat pv_Bottom;
/** 获取/设置view的右边坐标 */
@property (nonatomic, assign) CGFloat pv_Right;
/** 获取/设置view的size */
@property (nonatomic, assign) CGSize pv_Size;
/** 是否是苹果X系列(刘海屏系列) */
BOOL pv_IsIphoneX_ALL(void);
/** 屏幕大小 */
CGSize pv_ScreenSize(void);
/** 屏幕宽度 */
CGFloat pv_ScreenWidth(void);
/** 屏幕高度 */
CGFloat pv_ScreenHeight(void);
@end
NS_ASSUME_NONNULL_END

View File

@@ -0,0 +1,148 @@
//
// UIView+LSTPV.m
// LSTPopView
//
// Created by LoSenTrad on 2020/11/30.
//
#import "UIView+LSTPV.h"
@implementation UIView (LSTPV)
- (void)setPv_X:(CGFloat)pv_X {
CGRect frame = self.frame;
frame.origin.x = pv_X;
self.frame = frame;
}
- (CGFloat)pv_X {
return self.frame.origin.x;
}
- (void)setPv_Y:(CGFloat)pv_Y {
CGRect frame = self.frame;
frame.origin.y = pv_Y;
self.frame = frame;
}
- (CGFloat)pv_Y {
return self.frame.origin.y;
}
- (void)setPv_Width:(CGFloat)pv_Width {
CGRect frame = self.frame;
frame.size.width = pv_Width;
self.frame = frame;
}
- (CGFloat)pv_Width {
return self.frame.size.width;
}
- (void)setPv_Height:(CGFloat)pv_Height {
CGRect frame = self.frame;
frame.size.height = pv_Height;
self.frame = frame;
}
- (CGFloat)pv_Height {
return self.frame.size.height;
}
- (void)setPv_Size:(CGSize)pv_Size {
CGRect frame = self.frame;
frame.size = pv_Size;
self.frame = frame;
}
- (CGSize)pv_Size {
return self.frame.size;
}
- (void)setPv_CenterX:(CGFloat)pv_CenterX {
CGPoint center = self.center;
center.x = pv_CenterX;
self.center = center;
}
- (CGFloat)pv_CenterX {
return self.center.x;
}
- (void)setPv_CenterY:(CGFloat)pv_CenterY {
CGPoint center = self.center;
center.y = pv_CenterY;
self.center = center;
}
- (CGFloat)pv_CenterY {
return self.center.y;
}
- (void)setPv_Top:(CGFloat)pv_Top {
CGRect newframe = self.frame;
newframe.origin.y = pv_Top;
self.frame = newframe;
}
- (CGFloat)pv_Top {
return self.frame.origin.y;
}
- (void)setPv_Left:(CGFloat)pv_Left {
CGRect newframe = self.frame;
newframe.origin.x = pv_Left;
self.frame = newframe;
}
- (CGFloat)pv_Left {
return self.frame.origin.x;
}
- (void)setPv_Bottom:(CGFloat)pv_Bottom {
CGRect newframe = self.frame;
newframe.origin.y = pv_Bottom - self.frame.size.height;
self.frame = newframe;
}
- (CGFloat)pv_Bottom {
return self.frame.origin.y + self.frame.size.height;
}
- (void)setPv_Right:(CGFloat)pv_Right {
CGFloat delta = pv_Right - (self.frame.origin.x + self.frame.size.width);
CGRect newframe = self.frame;
newframe.origin.x += delta ;
self.frame = newframe;
}
- (CGFloat)pv_Right {
return self.frame.origin.x + self.frame.size.width;
}
/** X() */
BOOL pv_IsIphoneX_ALL(void) {
BOOL isPhoneX = NO;
if (@available(iOS 11.0, *)) {
isPhoneX = [[UIApplication sharedApplication] delegate].window.safeAreaInsets.bottom > 0.0;
}
return isPhoneX;
}
CGSize pv_ScreenSize(void) {
CGSize size = [UIScreen mainScreen].bounds.size;
return size;
}
CGFloat pv_ScreenWidth(void) {
CGSize size = [UIScreen mainScreen].bounds.size;
return size.width;
}
CGFloat pv_ScreenHeight(void) {
CGSize size = [UIScreen mainScreen].bounds.size;
return size.height;
}
@end

178
Pods/LSTPopView/README.md generated Normal file
View File

@@ -0,0 +1,178 @@
# LSTPopView iOS万能弹窗
[![Platform](https://img.shields.io/badge/platform-iOS-red.svg)](https://developer.apple.com/iphone/index.action) [![Language](http://img.shields.io/badge/language-OC-yellow.svg?style=flat )](https://en.wikipedia.org/wiki/Objective-C) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](http://mit-license.org) [![CocoaPods Compatible](https://img.shields.io/cocoapods/v/LSTPopView.svg)](https://img.shields.io/cocoapods/v/LSTPopView.svg)
### LSTPopView 万能弹窗,功能强大,易于拓展,性能优化和内存控制让其运行更加的流畅和稳健, LSTPopView的出现,可以让我们更专注弹窗页面的布局. 省心省力 ! 提高开发效率 !
## 前言
- 考虑到笔者的精力问题,遇到问题请先查看 API、效仿Demo、阅读README、搜索 Issues。如果是BUG 或 Feature,最好是提Issue
- 联系方式: LoSenTrad@163.com, QQ群:1045568246, 微信:a_LSTKit
- 开发环境: Xcode12.3, iOS13.5, iPhone XS Max
## 博客地址
- github: [https://github.com/LoSenTrad/LSTPopView](https://github.com/LoSenTrad/LSTPopView)
- CSDN: [https://blog.csdn.net/u012400600/article/details/106279654](https://blog.csdn.net/u012400600/article/details/106279654)
- 简书: [https://www.jianshu.com/p/8023a85dc2a2](https://www.jianshu.com/p/8023a85dc2a2)
## 目录
* [特性](#特性)
* [版本更新历史](#版本更新历史)
* [安装](#安装)
* [基本使用](#基本使用)
* [使用注意事项](#使用注意事项)
* [演示效果](#演示效果)
* [作者](#作者)
* [版权](#版权)
## 特性
- 提供丰富的api,高度自定义弹窗,简单入手使用
- 支持弹出动画,消失动画,主动动画等多重动画搭配
- 支持点击,长按,拖拽,横扫手势交互
- 支持多弹窗管理:编队,堆叠,优先级等
- 支持指定弹窗父类,eg: UIWindow,self.view等
- 安全且内存占用小,弹窗内存自动回收
- 提供生命周期api,自定义动画控制
- 自动规避键盘,防止被键盘遮挡
- 支持定时器,多定时器机制
- 支持纯代码/xib页面
- 支持横竖屏切换
- 支持多代理机制
- 支持二次封装,比如组件LSTHUD,LSTAlertView等
## 版本更新历史
- [点我查看](https://github.com/LoSenTrad/LSTPopView/blob/master/UPDATE_HISTORY.md)
## 安装
- OC版本安装
- CocoaPods安装: 在podfile文件中添加以下描述,然后 `pod install` 或者 `pod update`
```
pod 'LSTPopView'
```
- Carthage安装:(暂时未适配)
- Swift版本安装
- (计划开发中)
- 手动导入集成
- 1.拖动LSTPopView文件下5个文件到项目中
```objective-c
LSTPopView.h
LSTPopView.m
UIView+LSTPV.h
UIView+LSTPV.m
LSTPopViewProtocol.h
```
- 2.在项目中podfile添加依赖库LSTTimer: https://github.com/LoSenTrad/LSTTimer
```ruby
pod 'LSTTimer'
```
## 基本使用
- 代码示例
```objective-c
//自定义view
LSTPopViewTVView *customView = [[LSTPopViewTVView alloc] initWithFrame:CGRectMake(0, 0, 300,400)];
//创建弹窗PopViiew 指定父容器self.view, 不指定默认是app window
LSTPopView *popView = [LSTPopView initWithCustomView:customView
parentView:self.view
popStyle:LSTPopStyleSmoothFromBottom
dismissStyle:LSTDismissStyleSmoothToBottom];
//弹窗位置: 居中 贴顶 贴左 贴底 贴右
popView.hemStyle = LSTHemStyleBottom;
LSTPopViewWK(popView)
//点击背景触发
popView.bgClickBlock = ^{ [wk_popView dismiss]; };
//弹窗显示
[popView pop];
```
- 调试日志
```objective-c
/** 调试日志类型 */
typedef NS_ENUM(NSInteger, LSTPopViewLogStyle) {
LSTPopViewLogStyleNO = 0, // 关闭调试信息(窗口和控制台日志输出)
LSTPopViewLogStyleWindow, // 开启左上角小窗
LSTPopViewLogStyleConsole, // 开启控制台日志输出
LSTPopViewLogStyleALL // 开启小窗和控制台日志
};
```
- 调试小窗: S表示当前已经显示的弹窗数, R表示在移除队列的弹窗, S+R是表示当前所有的弹窗数
## 使用注意事项
#### (一定用weak修饰)
- 解析: LSTPopView对每个弹窗都有自动内存销毁机制, 外部对弹窗的强引用对打破这种自动内存销毁机制, 比如成员变量用strong修饰,否则弹窗不能自动销毁,导致内存回收不了.
- 类成员变量使用规范:
```objective-c
//成员变量用weak修饰, 不可以用strong修饰
@property (nonatomic,weak) LSTPopView *popView;
```
- 成员变量的创建
```objective-c
LSTPopViewTVView *customView = [[LSTPopViewTVView alloc] initWithFrame:CGRectMake(0, 0, 300,400)];
//弹窗实例创建
LSTPopView *popView = [LSTPopView initWithCustomView:customView
popStyle:LSTPopStyleSmoothFromBottom
dismissStyle:LSTDismissStyleSmoothToBottom];
//这里赋值给成员变量self.popView
self.popView = popView;
[popView pop];
```
- 错误使用:
```objective-c
//直接赋值给成员变量 导致成员变量为空, 请参考以上使用规范
self.popView = [LSTPopView initWithCustomView:customView
popStyle:LSTPopStyleSmoothFromBottom
dismissStyle:LSTDismissStyleSmoothToBottom];
```
## 演示效果
- 应用市场常用的示例场景
|QQ,微信,UC,微博,抖音<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/base_demo.gif" width = "200" height = "424" alt="图片名称" align=center />|拖拽移除,横扫移除<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/drag_sweep.gif" width = "200" height = "424" alt="图片名称" align=center /> |
|---|---|
- 丰富的出入场动画, 拖拽, 横扫动画
|弹出动画,中间,自上,自左,自下,自左<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/pop.gif" width = "200" height = "424" alt="图片名称" align=center />|移除动画,中间,至上,至左,至下,至左<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/dismiss.gif" width = "200" height = "424" alt="图片名称" align=center /> |拖拽,横扫动画<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/dragSweep.gif" width = "200" height = "424" alt="图片名称" align=center /> |
|---|---|---|
- 弹窗位置
|弹窗位置,中间,贴顶,贴左,贴底,贴右<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/hem_Style.gif" width = "200" height = "424" alt="图片名称" align=center />|X轴,Y轴调教,宽度和高度调教<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/x_y_w_h.gif" width = "200" height = "424" alt="图片名称" align=center /> |
|---|---|
- 自动规避键盘遮挡,指定容器,定时器
|自动规避键盘遮挡<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/keyboard.gif" width = "200" height = "424" alt="图片名称" align=center />|指定容器弹出<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/LSTPopView/%E6%8C%87%E5%AE%9A%E5%AE%B9%E5%99%A8.gif" width = "200" height = "424" alt="图片名称" align=center />|弹窗计时<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/LSTPopView/%E8%AE%A1%E6%97%B6%E5%99%A8.gif" width = "200" height = "424" alt="图片名称" align=center />|
|---|---|---|
- 多弹窗管理(优先级,编队)
|app启动多弹窗优先级显示<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/uPic/launch.gif" width = "200" height = "424" alt="图片名称" align=center />|多窗口编队使用<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/LSTPopView/%E7%AA%97%E5%8F%A3%E7%BC%96%E9%98%9F%E7%9A%84%E4%BD%BF%E7%94%A8.gif" width = "200" height = "424" alt="图片名称" align=center />|
|---|---|
- 支持横竖屏
|屏幕旋转<br><img src="https://raw.githubusercontent.com/5208171/LSTBlog/master/LSTPopView/%E5%B1%8F%E5%B9%95%E6%97%8B%E8%BD%AC.gif" width = "500" height = "500" alt="图片名称" align=center />|
|---|
## 作者
LoSenTrad@163.com, QQ群:1045568246, 微信:a_LSTKit
## 版权
尊重劳动成果, 人人有责.