/TextFieldsCatalog

This is catalog of various input field with great opportunities for validation and formatting.

Primary LanguageSwiftMIT LicenseMIT

TextFieldsCatalog

GitHubActions Build Status Documentation Version Platform License Swift Version codebeat badge

Overview

Данный репозиторий содержит коллекцию различных полей ввода, предоставляющих богатые возможности по проверке введенных значений и форматированию текста при вводе. К тому же, они просто симпатичные и хорошо кастомизируются :)

Полная документация - доступна на GitHub Pages

Installation

Cocoapods

Просто добавьте следующую строку в ваш Podfile:

pod 'TextFieldsCatalog'

First Step Guide

Предположим, вам необходимо реализовать поле ввода для Имени пользователя, которое должно быть от 5 до 25 символов и вас устраивает дизайн UnderlinedTextField, предоставляемый из коробки.

Вам необходимо выполнить следующие шаги:

  • добавить в Podfile pod 'TextFieldsCatalog', выполнить pod install, открыть .workspace
  • добавить на экран UIView, изменить его класс на UnderlinedTextField, установить высоту равной 77
  • во ViewController сделать IBOutlet на это поле, назвать, к примеру, textField
  • сконфигурировать поле ввода
textField.configure(placeholder: "Имя", maxLength: 25)
textField.configure(autocapitalizationType: .words)
textField.validator = TextFieldValidator(minLength: 5, maxLength: 25, regex: nil)

Этих действий вполне достаточно для базовой конфигурации поля ввода. Для получения более подробной информации - рекомендуется посмотреть Example проект и прочитать документацию.

Строение репозитория

Фактически, репозиторий включает в себя как и сам pod, так и полноценный Example проект, на котором можно сразу протестировать на деле новое поле или изменения в существующих.

Документация

Документация по тестовому проекту

Документ по проекту с каталогом полей ввода

Документация по возможностям полей ввода

Лицензия

TextFieldsCatalog распространяется под MIT лицензией