FWPopupViewOC 3.1.0

FWPopupViewOC 3.1.0

Maintained by xfg.



  • By
  • xfg

IOS之弹窗 -- OC/Swift4.x

Platform  Language  License

温馨提示:

1、同一窗口内目前只支持弹窗一个弹窗,如果需要同时展示两个弹窗,建议与系统或者其他自定义弹窗配合使用;
2、如需两个弹窗接连使用,请保证第一个弹窗完全消失再调用第二个弹窗;
3、鉴于方法或者属性可能跟着版本改动,因此强烈建议使用该库时封装一层后再使用;
4、如需在弹窗上展示SVProgressHUD,可设置:[SVProgressHUD setMaxSupportedWindowLevel:UIWindowLevelStatusBar+1];

支持pod导入:

pod 'FWPopupViewOC'
注意:如出现 [!] Unable to find a specification for 'FWPopupViewOC' 错误,可执行 pod repo update 命令。

简单使用:

OC:

只需要继承FWPopupBaseView:

@interface FWCustomView : FWPopupBaseView
@end

可设置参数:

/**
 标题字体大小
 */
@property (nonatomic, assign) CGFloat titleFontSize;
/**
 标题文字颜色
 */
@property (nonatomic, strong) UIColor *titleColor;

/**
 按钮字体大小
 */
@property (nonatomic, assign) CGFloat buttonFontSize;
/**
 按钮高度
 */
@property (nonatomic, assign) CGFloat buttonHeight;
/**
 普通按钮文字颜色
 */
@property (nonatomic, strong) UIColor *itemNormalColor;
/**
 高亮按钮文字颜色
 */
@property (nonatomic, strong) UIColor *itemHighlightColor;
/**
 选中按钮文字颜色
 */
@property (nonatomic, strong) UIColor *itemPressedColor;

/**
 上下间距
 */
@property (nonatomic, assign) CGFloat topBottomMargin;
/**
 左右间距
 */
@property (nonatomic, assign) CGFloat letfRigthMargin;
/**
 控件之间的间距
 */
@property (nonatomic, assign) CGFloat commponentMargin;

/**
 边框、分割线颜色
 */
@property (nonatomic, strong) UIColor *splitColor;
/**
 边框宽度
 */
@property (nonatomic, assign) CGFloat splitWidth;
/**
 圆角值
 */
@property (nonatomic, assign) CGFloat cornerRadius;

/**
 弹窗的背景色(注意:这边指的是弹窗而不是遮罩层,遮罩层背景色的设置是:fwMaskViewColor)
 */
@property (nonatomic, strong) UIColor *backgroundColor;
/**
 弹窗的最大高度,0:表示不限制
 */
@property (nonatomic, assign) CGFloat popupViewMaxHeight;

/**
 弹窗箭头的样式
 */
@property (nonatomic, assign) FWPopupArrowStyle popupArrowStyle;
/**
 弹窗箭头的尺寸
 */
@property (nonatomic, assign) CGSize popupArrowSize;
/**
 弹窗箭头的顶点的X值相对于弹窗的宽度,默认在弹窗X轴的一半,因此设置范围:0~1
 */
@property (nonatomic, assign) CGFloat popupArrowVertexScaleX;
/**
 弹窗圆角箭头的圆角值
 */
@property (nonatomic, assign) CGFloat popupArrowCornerRadius;
/**
 弹窗圆角箭头与边线交汇处的圆角值
 */
@property (nonatomic, assign) CGFloat popupArrowBottomCornerRadius;


// ===== 自定义弹窗(继承FWPopupView)时可能会用到 =====

/**
 弹窗校准位置
 */
@property (nonatomic, assign) FWPopupAlignment popupAlignment;
/**
 弹窗动画类型
 */
@property (nonatomic, assign) FWPopupAnimationStyle popupAnimationStyle;

/**
 弹窗偏移量
 */
@property (nonatomic, assign) UIEdgeInsets popupEdgeInsets;
/**
 遮罩层的背景色(也可以使用fwMaskViewColor),注意:该参数在弹窗隐藏后,还原为弹窗弹起时的值
 */
@property (nonatomic, strong) UIColor *maskViewColor;

/**
 0表示NO,1表示YES,YES:用户点击外部遮罩层页面可以消失,注意:该参数在弹窗隐藏后,还原为弹窗弹起时的值
 */
@property (nonatomic, copy) NSString *touchWildToHide;

/**
 显示、隐藏动画所需的时间
 */
@property (nonatomic, assign) NSTimeInterval animationDuration;

/**
 3D放射动画(当且仅当:popupAnimationStyle == .scale3D 时有效)
 */
@property (nonatomic, assign) CATransform3D transform3D;
/**
 2D放射动画
 */
@property (nonatomic, assign) CGAffineTransform transform;

效果:

更新记录:

• v2.1.0:

  • 弹窗基类(FWPopupBaseView)中增加让多余部分的遮罩层变为无色属性:shouldClearSpilthMask;
  • 新增新手引导弹窗:FWGuideMaskView;

• v2.1.1:

  • 新增拖动关闭的弹窗基类:FWPanPopupView;

• v2.1.2:

  • 修复点击非遮罩层视图会显示的问题;

• v2.1.3:

  • 修复弹窗为成员变量时,再次调起弹窗后位置发生变化的问题;

• v2.1.4:

  • 增加:保证前一次弹窗销毁的处理机制;

• v2.1.5:

  • 修复弹窗消失时内存泄漏问题;

• v2.1.6:

  • 修复xib加载View方式时,继承弹窗基类FWPopupBaseView崩溃问题;

• v2.1.9:

  • 添加弹窗状态:FWPopupState;
  • 根据状态对应的进行回调,这样子可以根据实际使用来回调,废除原:showWithBlock 和 hideWithBlock 方法,新增:showWithDidAppearBlock、showWithStateBlock、hideWithDidDisappearBlock 方法;

• v3.0.0(大版本):

  • 使用Masonry库重构了弹窗基类及部分弹窗视图;
  • 支持横竖屏切换(注意:shouldClearSpilthMask属性为YES时不支持横竖屏切换,会出现视图显示的问题);
  • 支持多个弹窗存在(详细请查看:同时显示两个弹窗的演示);

• v3.0.1:

  • 解决app进入后台时隐藏弹窗可能出现界面卡死问题;
  • 解决多次调用显示、隐藏的安全判断(会导致约束出错问题);
  • 增加hiddenViews添加视图的条件判断,解决某些视图已经创建了,但还未显示过一次依然会加入hiddenViews的问题;

• v3.0.3:

  • 支持重新设置弹窗视图size;
  • 添加两种弹窗状态:FWPopupStateDidAppearButCovered、FWPopupStateDidAppearAgain;

• v3.0.4:

  • 解决多个弹窗同时存在时,最后一个弹窗可能无法外部点击的问题;

• v3.0.5:

  • 解决(View controller-based status bar appearance = "YES")状态栏隐藏的情况下,弹窗时会显示出状态栏的问题;

结尾语:

  • 使用过程中发现bug请issues或加入FW问题反馈群:670698309(此群只接受FW相关组件问题);
  • 有新的需求欢迎提出;