UITextField
@_spi(FW) extension UITextField
-
输入事件代理,需手工设置delegate生效
Declaration
Swift
public var fw_textDelegate: TextFieldDelegate { get set }
-
是否启用键盘管理(自动滚动),默认NO
Declaration
Swift
@objc dynamic public var fw_keyboardManager: Bool { get set }
-
设置输入框和键盘的空白间距,默认10.0
Declaration
Swift
@objc dynamic public var fw_keyboardDistance: CGFloat { get set }
-
设置输入框和键盘的空白间距句柄,参数为键盘高度、输入框高度,优先级高,默认nil
Declaration
Swift
@objc dynamic public var fw_keyboardDistanceBlock: ((_ keyboardHeight: CGFloat, _ height: CGFloat) -> CGFloat)? { get set }
-
设置输入框和键盘的回弹触发最小距离,默认0始终回弹
Declaration
Swift
@objc dynamic public var fw_reboundDistance: CGFloat { get set }
-
是否启用键盘后台关闭处理,退后台时收起键盘,回到前台时恢复键盘,解决系统退后台输入框跳动问题,默认NO
Declaration
Swift
@objc dynamic public var fw_keyboardResign: Bool { get set }
-
是否启用点击背景关闭键盘(会继续触发其它点击事件),默认NO
Declaration
Swift
@objc dynamic public var fw_touchResign: Bool { get set }
-
指定用于键盘管理滚动的scrollView,默认为nil,通过修改VC.view.frame实现
Declaration
Swift
public weak var fw_keyboardScrollView: UIScrollView? { get set }
-
点击键盘完成按钮是否关闭键盘,默认NO,二选一
Declaration
Swift
@objc dynamic public var fw_returnResign: Bool { get set }
-
设置点击键盘完成按钮是否自动切换下一个输入框,二选一
Declaration
Swift
public var fw_returnNext: Bool { get set }
-
设置点击键盘完成按钮的事件句柄
Declaration
Swift
public var fw_returnBlock: ((UITextField) -> Void)? { get set }
-
获取关联的键盘Toolbar对象,可自定义样式
Declaration
Swift
public var fw_keyboardToolbar: UIToolbar { get set }
-
自定义键盘Toolbar上一个按钮,支持图片|字符串等(详见FWBlock),默认朝上的箭头
Declaration
Swift
public var fw_toolbarPreviousButton: Any? { get set }
-
自定义键盘Toolbar下一个按钮,支持图片|字符串等(详见FWBlock),默认朝下的箭头
Declaration
Swift
public var fw_toolbarNextButton: Any? { get set }
-
自定义键盘Toolbar完成按钮,支持图片|字符串等(详见FWBlock),默认Done
Declaration
Swift
public var fw_toolbarDoneButton: Any? { get set }
-
设置Toolbar点击前一个按钮时聚焦的输入框句柄,默认nil
Declaration
Swift
public var fw_previousResponder: ((UITextField) -> UIResponder?)? { get set }
-
设置Toolbar点击下一个按钮时聚焦的输入框句柄,默认nil
Declaration
Swift
public var fw_nextResponder: ((UITextField) -> UIResponder?)? { get set }
-
设置Toolbar点击前一个按钮时聚焦的输入框tag,默认0不生效
Declaration
Swift
public var fw_previousResponderTag: Int { get set }
-
设置Toolbar点击下一个按钮时聚焦的输入框tag,默认0不生效
Declaration
Swift
public var fw_nextResponderTag: Int { get set }
-
自动跳转前一个输入框,优先使用previousResponder,其次根据responderTag查找
Declaration
Swift
public func fw_goPrevious()
-
自动跳转后一个输入框,优先使用nextResponder,其次根据responderTag查找
Declaration
Swift
public func fw_goNext()
-
获取键盘弹出时的高度,对应Key为UIKeyboardFrameEndUserInfoKey
Declaration
Swift
public func fw_keyboardHeight(_ notification: Notification) -> CGFloat
-
执行键盘跟随动画,支持AutoLayout,可通过keyboardHeight:获取键盘高度
Declaration
Swift
public func fw_keyboardAnimate(_ notification: Notification, animations: @escaping () -> Void, completion: ((Bool) -> Void)? = nil)
-
添加Toolbar,指定标题和完成句柄,使用默认按钮
Declaration
Swift
public func fw_addToolbar(title: Any? = nil, doneBlock: ((Any) -> Void)? = nil)
Parameters
title
标题,不能点击
doneBlock
右侧完成按钮句柄,默认收起键盘
-
添加Toolbar,指定居中标题、左侧上一个、下一个按钮和右边按钮
Declaration
Swift
public func fw_addToolbar(titleItem: UIBarButtonItem?, previousItem: UIBarButtonItem?, nextItem: UIBarButtonItem?, doneItem: UIBarButtonItem?)
Parameters
titleItem
居中标题按钮
previousItem
左侧前一个按钮
nextItem
左侧下一个按钮
doneItem
右侧完成按钮
-
最大字数限制,0为无限制,二选一
Declaration
Swift
public var fw_maxLength: Int { get set }
-
最大Unicode字数限制(中文为1,英文为0.5),0为无限制,二选一
Declaration
Swift
public var fw_maxUnicodeLength: Int { get set }
-
自定义文字改变处理句柄,自动trimString,默认nil
Declaration
Swift
public var fw_textChangedBlock: ((String) -> Void)? { get set }
-
文本长度发生改变,自动检测字数限制,用于代码设置text等场景
Declaration
Swift
public func fw_textLengthChanged()
-
获取满足最大字数限制的过滤后的文本,无需再调用textLengthChanged
Declaration
Swift
public func fw_filterText(_ text: String) -> String
-
设置自动完成时间间隔,默认0.5秒,和autoCompleteBlock配套使用
Declaration
Swift
public var fw_autoCompleteInterval: TimeInterval { get set }
-
设置自动完成处理句柄,自动trimString,默认nil,注意输入框内容为空时会立即触发
Declaration
Swift
public var fw_autoCompleteBlock: ((String) -> Void)? { get set }
-
是否禁用长按菜单(拷贝、选择、粘贴等),默认NO
Declaration
Swift
public var fw_menuDisabled: Bool { get set }
-
自定义光标偏移和大小,不为0才会生效,默认zero不生效
Declaration
Swift
public var fw_cursorRect: CGRect { get set }
-
获取及设置当前选中文字范围
Declaration
Swift
public var fw_selectedRange: NSRange { get set }
-
移动光标到最后
Declaration
Swift
public func fw_selectAllRange()
-
移动光标到指定位置,兼容动态text赋值
Declaration
Swift
public func fw_moveCursor(_ offset: Int)