Close Menu

singlelineinput

The SingleLineInput framework provides a reusable component for creating single-line input fields in iOS applications. This framework simplifies the process of building user interfaces by offering a customizable and highly functional single-line input view.

Features

  • Elegant and customizable design
  • Supports various text input types
  • Validation options for user input
  • Auto-capitalization support
  • Formatted text input using masks
  • Automatic handling of keyboard appearance and dismissal

Installation

  1. Using Cocoapods:
    2. pod 'SingleLineInput'
  2. Manual installation:
    • Download the latest release from the SingleLineInput GitHub repository.
    • Copy the SingleLineInput.framework file to your project directory.
    • Add the framework to your Xcode project.

Usage

To use the SingleLineInput framework in your project:

  1. Add the following import statement to your Swift file:
    2. import SingleLineInput
  2. Create an instance of SingleLineInputView:
    3. let singleLineInputView = SingleLineInputView(frame: CGRect(x: 0, y: 0, width: 200, height: 40))
  3. Customize the input field as desired:
    4. singleLineInputView.placeholder = "Enter your name"
  4. Add the SingleLineInputView as a subview:
    5. view.addSubview(singleLineInputView)
  5. Handle user input using the provided delegate methods:
    6. singleLineInputView.delegate = self

Customization

The SingleLineInput framework offers several customization options:

  1. Appearance: Change the appearance of the input field, including text color, background color, border styles, etc.
    2. singleLineInputView.font = UIFont.systemFont(ofSize: 16)
    singleLineInputView.textColor = UIColor.black
    singleLineInputView.backgroundColor = UIColor.white
  2. Text Input Type: Select the type of textual input expected from the user (e.g., email, password, number, etc.).
    3. singleLineInputView.inputType = .emailAddress
  3. Validation: Validate user input according to specific criteria (e.g., email format, password complexity, etc.).
    4. singleLineInputView.validationType = .email
  4. Auto-capitalization: Determine whether the first letter of each word should automatically be capitalized.
    5. singleLineInputView.autoCapitalizationType = .words
  5. Formatted Input: Apply a format mask to enforce a specific input pattern (e.g., phone number format).
    6. singleLineInputView.formatMask = "###-###-####"

Delegate Methods

The SingleLineInputViewDelegate protocol defines the following methods:

  • inputDidChange(_ input: String): Called when the user input changes.
  • textFieldShouldReturn(): Called when the “Return” key is pressed.
extension ViewController: SingleLineInputViewDelegate {
    func inputDidChange(_ input: String) {
        // Handle input changes
    }
    
    func textFieldShouldReturn() {
        // Handle return key press
    }
}

Additional Notes

  • This framework supports iOS 10 and later versions.
  • For more details and examples, refer to the official SingleLineInput documentation on GitHub.