CBPinEntryView
CBPinEntryView 是一个用于实现输入密码、代码或虚拟指纹的视图。它允许退格、关闭键盘并从上次离开的地方继续,整个代码作为单个 String 或 Int 提供,并且该视图可以通过代码或故事板轻松地进行自定义。
预览
轻松地输入密码! | 与用户进行错误通信 | 清除文本框以重试 | 安全输入模式 |
---|---|---|---|
示例
要运行示例项目,请克隆仓库,然后在 Example 目录中首先运行 pod install
。
安装
CBPinEntryView 通过 CocoaPods 提供。要安装它,只需将以下行添加到您的 Podfile 中:
pod "CBPinEntryView"
将视图(View)放入您的故事板(Storyboard)或xib中,并将它的类设置为 CBPinEntryView
。在文件中创建一个 Output 并通过 IBInspectable 属性或代码进行自定义。
获取代码
使用 entryView.getPinAsString()
或 entryView.getPinAsInt()
获取代码。
输入回调函数
有两种委托方法 entryChanged(_ completed: Bool)
和 entryCompleted(with entry: String?)
。第一个会在输入每次改变时通知您,并告知它们是否已经完成输入。第二个函数将在用户完成输入时被调用,并且输入的 PIN 会传递过来。
安全输入
使用可自定义的安全字符(从 ● 更改为 ✱ 或任何其他字符)进行安全输入。启用 isSecure
。通过设置 secureCharacter
属性更改安全输入字符。
显示错误
存在一个错误模式,可以通过 pinEntryView.setError(isError: true)
启用,通过 pinEntryView.setError(isError: false)
禁用。可以通过 pinEntryView.errorMode
检查错误模式是否启用。调用 pinEntryView.resignFirstResponder()
将隐藏键盘并禁用错误模式。
允许或限制字符
设置 allowedEntryTypes
并在 any
、numerical
、alphanumeric
、letters
之间选择以启用或限制字符。通过设置 textFieldCapitalization
来选择您希望在文本字段中使用的类型的大写。
自定义键盘类型!
键盘类型是一个带有整型原始值的枚举。选项如下:
0: default // Default type for the current input method.
1: asciiCapable // Displays a keyboard which can enter ASCII characters
2: numbersAndPunctuation // Numbers and assorted punctuation.
3: URL // A type optimized for URL entry (shows . / .com prominently).
4: numberPad // A number pad with locale-appropriate digits (0-9, ۰-۹, ०-९, etc.). Suitable for PIN entry.
5: phonePad // A phone pad (1-9, *, 0, #, with letters under the numbers).
6: namePhonePad // A type optimized for entering a person's name or phone number.
7: emailAddress // A type optimized for multiple email address entry (shows space @ . prominently).
8: decimalPad // A number pad with a decimal point.
9: twitter // A type optimized for twitter text entry (easy access to @ #)
许可
CBPinEntryView 在 MIT 许可下可用。有关更多信息,请参阅 LICENSE 文件。