iOS - 面向协议封装全屏旋转功能
关于使用面向协议来封装功能的实战可以参考我上篇文章 【iOS-面向协议方式封装空白页功能】，这里就不再赘述，我们直接进入使用阶段吧。 本篇文章只有一个目的，那就是只要遵守协议，一行代码随意切换全屏～
如果对面向协议有疑问的同学可以看下我之前的两篇文章
# 开源库
| Name | Link |
|---|---|
| GitHub | LXFProtocolTool (opens new window) |
| Wiki | Wiki首页 (opens new window) |
| 本文 Demo | LXFFullScreenable (opens new window) |
使用Cocoapods的方式来安装即可
pod 'LXFProtocolTool/FullScreenable'
# 一、配置
在AppDelegate中实现如下方法
func application(_ application: UIApplication, supportedInterfaceOrientationsFor window: UIWindow?) -> UIInterfaceOrientationMask {
return UIApplication.shared.lxf.currentVcOrientationMask
}
# 二、使用案例
方法与属性的调用都需要命名空间加上
lxf，如isFullScreen->lxf.isFullScreen
isFullScreen : 获取当前遵守协议者是否为全屏状态
func switchFullScreen(
isEnter: Bool? = nil,
specifiedView: UIView? = nil,
superView: UIView? = nil,
config: FullScreenableConfig? = nil,
completed: ((_ isFullScreen: Bool)->Void)? = nil
)
| Name | Type | Desc |
|---|---|---|
| isEnter | Bool? | 是否进入全屏 |
| specifiedView | UIView? | 指定即将全屏的视图 |
| superView | UIView? | 作为退出全屏后specifiedView的父视图 |
| config | FullScreenableConfig? | 配置 |
| completed | ((_ isFullScreen: Bool)->Void)? | 进入/退出 全屏后的回调 |
当
switchFullScreen的调用者为UIView时，如果specifiedView为nil会自动填写，superView也是如此
switchFullScreen方法不推荐直接使用，不过当遵守协议者为UIViewController时，可以通过使用默认参数来切换屏幕方向lxf.switchFullScreen()
以下分两种情况说明
# UIViewController
func enterFullScreen(
specifiedView: UIView,
config: FullScreenableConfig? = nil,
completed: FullScreenableCompleteType? = nil
)
func exitFullScreen(
superView: UIView,
config: FullScreenableConfig? = nil,
completed: FullScreenableCompleteType? = nil
)
以上两个方法是对
switchFullScreen的抽离，使调用时对参数的传递更加清晰
1、遵守协议 FullScreenable
class LXFFullScreenableController: UIViewController, FullScreenable { }
2、指定视图进入全屏
lxf.enterFullScreen(specifiedView: cyanView)
3、指定视图退出全屏，并添加到当前控制器的view上
lxf.exitFullScreen(superView: self.view)
# 🔥自动进入|退出全屏
func autoFullScreen(
specifiedView: UIView,
superView: UIView,
config: FullScreenableConfig? = nil
)
- 控制器可以调用该方法来注册自动进入或退出全屏，各控制器之间互不影响。
view手动进入全屏会屏蔽当前控制器的自动全屏功能，退出方可恢复
# UIView
func enterFullScreen(
specifiedView: UIView? = nil,
config: FullScreenableConfig? = nil,
completed: FullScreenableCompleteType? = nil
)
func exitFullScreen(
superView: UIView? = nil,
config: FullScreenableConfig? = nil,
completed: FullScreenableCompleteType? = nil
)
以上两个方法是对
switchFullScreen的抽离，使调用时对参数的传递更加清晰
1、遵守协议 FullScreenable
class LXFFullScreenView: UIButton, FullScreenable { }
let cyanView = LXFFullScreenView()
2、进入全屏
cyanView.lxf.enterFullScreen()
3、退出全屏
cyanView.lxf.exitFullScreen()
这里是对遵守了
FullScreenable协议的视图进入全屏切换，由于代码内部已经经过自动视图填写，所以直接调用相应的方法即可，当然也可以自己指定specifiedView和superView
# 三、FullScreenableConfig说明
上述的方法都有一个
config参数，默认为nil，即为默认配置
相关属性说明
| Name | Type | Desc | Default |
|---|---|---|---|
| animateDuration | Double | 进入/退出 全屏时的旋转动画时间 | 0.25 |
| enterFullScreenOrientation | UIInterfaceOrientation | 进入全屏时的初始方向 | landscapeRight |
这里我们把动画时间设置为1s，初始方向为左后来看看效果
FullScreenableConfig(
animateDuration: 1,
enterFullScreenOrientation : .landscapeLeft
)
cyanView.lxf.enterFullScreen(config: diyConfig)
cyanView.lxf.exitFullScreen(config: diyConfig)
# 结语
到这里相关的说明已罗列完毕，有什么不清楚的可以下载Demo (opens new window)看看，或者在文章下方留言提问
LXFProtocolTool (opens new window) 主要是通过协议的方式来方便快捷地实现一些的实用功能，除了本文提及的全屏旋转功能外还有其它实用功能的封装，具体内容可以到 Wiki首页 (opens new window) 查找。如果你有什么想实现的功能也可以提出来，喜欢的就给个Star鼓励下我吧 🚀 🚀 🚀，感谢支持！
