UIView Extensions

Overview

The UIView extensions provide per-view customization of keyboard management behavior through the .iq wrapper pattern. These extensions allow you to override global settings for specific text input views.

The `.iq` Wrapper Pattern

All extension properties are accessed through the .iq namespace on UIView instances:

textField.iq.distanceFromKeyboard = 30.0
textField.iq.enableMode = .disabled

This pattern keeps IQKeyboardManager extensions cleanly separated from native UIKit APIs.

Properties

CGFloat

default:"UIView.defaultKeyboardDistance"

Custom distance from keyboard for this specific text input view.If set to UIView.defaultKeyboardDistance, the global keyboardDistance value from IQKeyboardManager.shared.keyboardDistance will be used. Otherwise, this value takes precedence.Note: Value cannot be negative. Negative values may cause unexpected behavior.

// Use global setting
textField.iq.distanceFromKeyboard = UIView.defaultKeyboardDistance

// Use custom distance of 50 points
textField.iq.distanceFromKeyboard = 50.0

IQEnableMode

default:".default"

Enable mode for this specific text input view.Controls whether keyboard management is enabled, disabled, or uses the default global setting for this view.Values:

.default - Use global IQKeyboardManager.shared.isEnabled setting
.enabled - Force enable keyboard management for this view
.disabled - Force disable keyboard management for this view

// Use global setting
textField.iq.enableMode = .default

// Always enable for this field
textField.iq.enableMode = .enabled

// Always disable for this field (useful for custom keyboards)
textField.iq.enableMode = .disabled

Available Properties Summary

Property	Type	Default	Description
`distanceFromKeyboard`	`CGFloat`	`UIView.defaultKeyboardDistance`	Custom keyboard distance for this view
`enableMode`	`IQEnableMode`	`.default`	Enable/disable mode for this view

Usage Examples

Custom Distance for Specific Fields

class MyViewController: UIViewController {
    @IBOutlet weak var emailTextField: UITextField!
    @IBOutlet weak var passwordTextField: UITextField!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Email field needs more space from keyboard
        emailTextField.iq.distanceFromKeyboard = 50.0
        
        // Password field uses default distance
        passwordTextField.iq.distanceFromKeyboard = UIView.defaultKeyboardDistance
    }
}

Disabling Keyboard Management for Custom Keyboards

class CustomKeyboardViewController: UIViewController {
    @IBOutlet weak var customTextField: UITextField!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Disable IQKeyboardManager for fields with custom input views
        customTextField.iq.enableMode = .disabled
        customTextField.inputView = customKeyboardView
    }
}

Force Enable for Specific Fields

class FormViewController: UIViewController {
    @IBOutlet weak var importantTextField: UITextField!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // Force enable even if IQKeyboardManager is globally disabled
        importantTextField.iq.enableMode = .enabled
        importantTextField.iq.distanceFromKeyboard = 20.0
    }
}

Core

Appearance

Extensions

Modules

Overview

The `.iq` Wrapper Pattern

Properties

Available Properties Summary

Usage Examples

Custom Distance for Specific Fields

Disabling Keyboard Management for Custom Keyboards

Force Enable for Specific Fields

See Also

​Overview

​The .iq Wrapper Pattern

​Properties

​Available Properties Summary

​Usage Examples

​Custom Distance for Specific Fields

​Disabling Keyboard Management for Custom Keyboards

​Force Enable for Specific Fields

​See Also

Overview

The `.iq` Wrapper Pattern

Properties

Available Properties Summary

Usage Examples

Custom Distance for Specific Fields

Disabling Keyboard Management for Custom Keyboards

Force Enable for Specific Fields

See Also