MISFloatingBall

简介

一个轻量级的简单到爆炸的悬浮球（详细使用可参见Demo）

功能

• [x] 全局和指定View生效的悬浮球类型
• [x] 自动靠边
• [x] 自动靠边并缩进，自定义缩进状态
• [x] 设置图片内容
• [x] 设置文字内容
• [x] 设置自定义内容
• [x] 点击悬浮球回调
• [ ] 扩展视图，点击弹出（见游戏App中的悬浮球）
• [ ] 旋转适配

使用说明

• 导入

  pod 'MISFloatingBall'

• 或者指定版本

  pod 'MISFloatingBall', '1.0.0'

• 初始化

  MISFloatingBall *floatingBall = [[MISFloatingBall alloc] initWithFrame:CGRectMake(100, 100, 100, 100)];// 全局作用
  MISFloatingBall *floatingBall = [[MISFloatingBall alloc] initWithFrame:CGRectMake(100, 100, 100, 100) inSpecifiedView:nil UIEdgeInsetsMake(64, 0, 0, 0)];   // 生成全局范围的悬浮球，并且有限制范围
  MISFloatingBall *floatingBall = [[MISFloatingBall alloc] initWithFrame:CGRectMake(100, 100, 100, 100) inSpecifiedView:self.view effectiveEdgeInsets:UIEdgeInsetsMake(64, 0, 0, 0)]; // 生成一个指定 view 生效的悬浮球，并且有限制范围

• 显示和隐藏

  [floatingBall show];        // 显示
  [floatingBall hide];        // 隐藏

• 生成后是否自动靠边

  floatingBall.autoCloseEdge = YES;

• 更改悬浮球的靠边策略（默认是上下左右都可以靠，默认时候的逻辑是和系统的assistiveTouch相同，接触到底部或顶部一定距离之后靠近上下边缘）

  floatingBall.edgePolicy = MISFloatingBallEdgePolicyLeftRight;

• 设置悬浮球显示的内容（内部自动居中）

  // 设置图片 
  [floatingBall setContent:[UIImage imageNamed:@"apple"] contentType:MISFloatingBallContentTypeImage];
  
  // 设置文字
  [floatingBall setContent:@"我是文字" contentType:MISFloatingBallContentTypeText];

• 如果想要添加一个自定义的视图到悬浮球中

  // 设置一个自定义的视图
  MISCustomButton *button = [[MISCustomButton alloc] initWithFrame:CGRectMake(0, 0, 80, 80)];
  button.titleLabel.textAlignment = NSTextAlignmentCenter;
  button.imageSize = CGSizeMake(44, 44);
  button.titleLabel.font = [UIFont systemFontOfSize:16.0f];
  button.backgroundColor = [UIColor redColor];
  
  [button setImage:[UIImage imageNamed:@"apple"] forState:UIControlStateNormal];
  [button setTitle:@"一个图片" forState:UIControlStateNormal];
  
  // 设置自定义视图
  [floatingBall setContent:button contentType:MISFloatingBallContentTypeCustomView];

• 当在autoCloseEdge为YES的时候，设置一段间隔后自动缩进边缘

  // 缩进的主要参数
  UIKIT_STATIC_INLINE MISEdgeRetractConfig MISEdgeOffsetConfigMake(CGPoint edgeRetractOffset, CGFloat edgeRetractAlpha) {
     MISEdgeRetractConfig config = {edgeRetractOffset, edgeRetractAlpha};
     return config;
  }
  
  // 设置缩进
  // 缩进时候如果靠的是左右边缘则x缩进20，如果上下则y缩进30，并且缩进后悬浮球透明度渐变为0.7f
  [floatingBall autoEdgeRetractDuration:3.0f edgeRetractConfigHander:^MISEdgeRetractConfig{
      return MISEdgeOffsetConfigMake(CGPointMake(20, 30), 0.7f);
  }];

• 悬浮球的点击

  globallyBall.clickHandler = ^(MISFloatingBall * _Nonnull floatingBall) {
      [floatingBall disVisible];
  };
  
  // 或者设置代理，在实现代理方法，获取点击事件
  - (void)didClickFloatingBall:(MISFloatingBall *)floatingBall {
      // 悬浮球点击
  }

系统要求

最低支持 iOS 8.0 和 Xcode 8.0。

Issue

如果存在 Bug 或有重大问题欢迎 Issue me，希望可以一起共同学习进步