GRSTextField 1.0.1

GRSTextField 1.0.1

Guilherme Ramos 维护。



GRSTextField 构建状态 Carthage 兼容 版本 GitHub 协议 GitHub 发布

Interface Builder

可以使用两种方式使用字段,其中一种(也是最方便的)是使用 Interface Builder(IB)。您可以将 UITextField 拖动到视图中,将其类设置为 GRSTextField,之后您将看到一组可以调整的属性,并可以在 IB 中预览更改。

Properties Panel

代码

要将错误标签设置为字段的输出,只需将标签拖动到您的故事板(或xib)上的任何位置,选择您的文本字段,转到连接检查器,并将其连接到“errorLabel”输出。

Connections Panel

还可以通过代码设置一些属性。

// Initialize the field setting the rect for its frame
let textField = GRSTextField(frame: rect)

// Sets the mask pattern for the field
textField.maskPattern = "####-###"

// Set the maximum number of characters for the Field
// it will be ignored if the field has a mask pattern
textField.maxCharacters = 8

// Defines if the will will have borders or not
textField.hasBorders = true

// Error message that will be shown on your error label
textField.errorMessage = "Required field"

// If you want to setup an error label to your field
textField.errorLabel = errorLabel

如果您想在设置字段值后立即对其进行加密。

textField.text = "1234567"
textField.applyMask()

属性解释

可检查项目

掩码模式

每当您想使字段仅接受数字并同时限制其最大字符数时,请为它设置掩码。如果为字段设置掩码,则将自动将其键盘类型更改为 .numberPad。例如:#####-#### 将将 1234567 转换为 1234-567

错误消息键

将使用此属性上设置的文本作为错误标签输出的文本。

是否有边框

切换字段下方的底线。

最大字符数

如果你的字段接受字母数字,并且你想要设置该字段的字符最大值,请为该属性设置一个数字来处理,但只有当你的 掩码模式 属性为空时,否则字段将优先处理模式属性并忽略此属性。

不可检查的对象

有效

该属性将确定您的字段是否被正确填充。默认情况下,当您的字段为空并且设置了错误消息或错误标签时,此属性将被设置为false。

您也可以使用自定义验证在代码中设置此属性。

颜色

以下颜色将应用于边框和错误标签(或提示)。

错误颜色

默认情况下,该颜色为红色。当字段为空或“有效”属性设置为false时,此颜色将被应用。

边框颜色

默认情况下,此颜色为灰色。当字段空闲且设置正确时,将应用此颜色。

已选颜色

默认情况下,此颜色为蓝色。当字段有效且已选时,将应用此颜色。

当前支持

语言:Swift 4

如果您需要或想要使用此字段的较旧版本,可以在 GRTextField 找到其 Objective-C 版本。

许可协议

GRSTextField 在 MIT 许可协议下提供。更多信息请参阅 LICENSE 文件。