Latest 0.2
Homepage https://github.com/giginet/CustomKeyboardTextField
License MIT
Platforms ios 8.0, requires ARC
Authors

Build Status
codecov
Language
Platform
CocoaPods Compatible
Carthage compatible
License

CustomKeyboardTextField provides easy way to make TextField with custom keyboards.

This library is under development so interfaces might change.

Demo

Demo application is available on Appetize.io.

Usage

Simple Picker

import CustomKeyboardTextField

struct SimplePickerKeyboardDataSource: UIPickerViewKeyboardDataSource {
    let elements = ["Bulbasaur", "Charmander", "Squirtle"]
}

typealias SimplePickerTextField = PickerKeyboardTextField<SimplePickerKeyboardDataSource>

let pickerTextField = SimplePickerTextField()
addSubView(pickerTextField)

If you’d like to change input text, override inputText(for row: Int).

You can also implement rich picker views. See sample implementation for detail.

Date Picker

import CustomKeyboardTextField

struct  DatePickerKeyboardDataSource: UIDatePickerKeyboardDataSource {
    let datePickerMode: UIDatePickerMode = .Date
    let timeFormat: String = "yyyy/MM/dd"
}
typealias DatePickerTextField = UIDatePickerKeyboardTextField<DatePickerKeyboardDataSource>

You can configure some parameters in UIDatePickerKeyboardDataSource.

Custom Keyboard

You can implement own custom keyboard easily.

1. Implement the custom keyboard view

// Your custom view
class MyCustomKeyboardView: UIView, CustomKeyboardView {
    weak var textField: UITextField?

    // current input text
    var inputText: String = "input text"

    // do something when keyboards are restored to default (optional)
    func reset() {
    }
}

You can put some controls on your keyboard (button, switch, text fields etc…).
When these are interacted, you execute updateTextField() then inputText is reflected in the text field.

2. Define CustomKeyboardProvider

struct MyKeyboardProvider: CustomKeyboardProvider {
    weak var textField: UITextField!

    init(with textField: UITextField) {
        self.textField = textField
    }

    func inputView(with textField: UITextField) -> CustomKeyboardView? {
        // Return keyboard view
        let myKeyboardView = MyCustomKeyboardView()
        myKeyboardView.textField = textField
        return myKeyboardView
    }

    func inputAccessoryView(with textField: UITextField) -> CustomKeyboardAccessoryView? {
        // Return CustomKeyboardAccessoryView or nil
        // ToolbarKeyboardAccessoryView is built-in
        // Of cource, you can implement your own toolbars
        // CustomKeyboardAccessoryView has same interface with CustomKeyboardView
        let accessoryView = ToolbarKeyboardAccessoryView(with: textField)
        return accessoryView
    }
}

3. Define CustomKeyboardTextField

typealias MyKeyboardTextField = CustomKeyboardTextField<MyKeyboardProvider>

See sample implementation for detail.

Installation

Carthage

github "giginet/CustomKeyboardTextField"

CocoaPods

use_frameworks!

pod "CustomKeyboardTextField"

Requirements

  • iOS 8 or above
  • Swift 2.2, 2.3

Author

giginet >

LICENSE

MIT License

Latest podspec

{
    "name": "CustomKeyboardTextField",
    "version": "0.2",
    "summary": "Provides easy way to make type safety TextField with custom keyboards.",
    "description": "CustomKeyboardTextField provides easy way to make type safety TextField with custom keyboards.",
    "homepage": "https://github.com/giginet/CustomKeyboardTextField",
    "screenshots": "https://raw.githubusercontent.com/giginet/CustomKeyboardTextField/master/Documentation/Image/demo.gif",
    "license": {
        "type": "MIT",
        "file": "LICENSE.md"
    },
    "authors": {
        "giginet": "[email protected]"
    },
    "social_media_url": "http://twitter.com/giginet",
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/giginet/CustomKeyboardTextField.git",
        "tag": "0.2"
    },
    "source_files": [
        "Sources",
        "Sources/**/*.{h,swift}"
    ],
    "public_header_files": "Sources/**/*.h",
    "requires_arc": true
}

Pin It on Pinterest

Share This