An easy-to-use, powerful, customizable pattern lock view in swift. 图形解锁/手势解锁 / 手势密码 / 图案密码 / 九宫格密码
相比于其他同类三方库有哪些优势:
- 完全面对协议编程,支持高度自定义网格视图和连接线视图,轻松实现各类不同需求;
- 默认支持多种配置效果,支持大部分主流效果,引入就可以搞定需求;
- 源码采用Swift5编写,通过泛型、枚举、函数式编程优化代码,具有更高的学习价值;
- 后期会持续迭代,不断添加主流效果;
效果预览
说明 | Gif |
---|---|
箭头 | |
中间点自动连接 | |
小灰点 | |
小白点 | |
荧光蓝 | |
fill白色 | |
阴影 | |
图片 | |
旋转(鸡你太美) | |
破折线 | |
图片连接线(箭头) | |
图片连接线(小鱼儿) | |
设置密码 | |
修改密码 | |
验证密码 |
要求
- iOS 9.0+
- Xcode 10.2.1+
- Swift 5.0
安装
手动
Clone代码,把Sources文件夹拖入项目,就可以使用了;
CocoaPods
target '<Your Target Name>' do
pod 'JXPatternLock'
end
先执行pod repo update
,再执行pod install
Carthage
在cartfile文件添加:
github "pujiaxin33/JXPatternLock"
然后执行carthage update --platform iOS
即可
使用
PatternLockViewConfig
初始化LockConfig
方式一:使用LockConfig
是默认提供的类,实现了PatternLockViewConfig
协议。可以直接通过LockConfig
的属性进行自定义。
let config = LockConfig()
config.gridSize = CGSize(width: 70, height: 70)
config.matrix = Matrix(row: 3, column: 3)
config.errorDisplayDuration = 1
PatternLockViewConfig
协议的类
方式二:新建实现该方式可以将所有配置细节聚集到自定义类的内部,外部只需要初始化自定义类即可。详情请参考demo里面的ArrowConfig
类。这样有个好处就是,多个地方都需要用到同样配置的时候,只需要初始化相同的类,而不用像使用LockConfig
那样,复制属性配置代码。
struct ArrowConfig: PatternLockViewConfig {
var matrix: Matrix = Matrix(row: 3, column: 3)
var gridSize: CGSize = CGSize(width: 70, height: 70)
var connectLine: ConnectLine?
var autoMediumGridsConnect: Bool = false
//其他属性配置!只是示例,就不显示所有配置项,影响文档长度
}
GridView
配置config.initGridClosure = {(matrix) -> PatternLockGrid in
let gridView = GridView()
let outerStrokeLineWidthStatus = GridPropertyStatus<CGFloat>.init(normal: 1, connect: 2, error: 2)
let outerStrokeColorStatus = GridPropertyStatus<UIColor>(normal: tintColor, connect: tintColor, error: .red)
gridView.outerRoundConfig = RoundConfig(radius: 33, lineWidthStatus: outerStrokeLineWidthStatus, lineColorStatus: outerStrokeColorStatus, fillColorStatus: nil)
let innerFillColorStatus = GridPropertyStatus<UIColor>(normal: nil, connect: tintColor, error: .red)
gridView.innerRoundConfig = RoundConfig(radius: 10, lineWidthStatus: nil, lineColorStatus: nil, fillColorStatus: innerFillColorStatus)
return gridView
}
ConnectLine
配置let lineView = ConnectLineView()
lineView.lineColorStatus = .init(normal: tintColor, error: .red)
lineView.triangleColorStatus = .init(normal: tintColor, error: .red)
lineView.isTriangleHidden = false
lineView.lineWidth = 3
config.connectLine = lineView
PatternLockView
初始化lockView = PatternLockView(config: config)
lockView.delegate = self
view.addSubview(lockView)
结构
完全遵从面对协议开发。
PatternLockView
依赖于配置协议PatternLockViewConfig
。
PatternLockViewConfig
依赖配置网格协议PatternLockGrid
和连接线协议ConnectLine
。
补充
如果刚开始使用JXPatternLock
,当开发过程中需要支持某种特性时,请务必先搜索使用文档或者源代码。确认是否已经实现支持了想要的特性。请别不要文档和源代码都没有看,就直接提问,这对于大家都是一种时间浪费。如果没有支持想要的特性,欢迎提Issue讨论,或者自己实现提一个PullRequest。
使用过程中,有任何建议或问题,可以通过以下方式联系我:
邮箱:[email protected]
喜欢就star
License
JXPatternLock is released under the MIT license.