2.1.3 文本-输入
TextField
构建及样式
TextField 具有多个构建方法,最简单的如下:
|
|
$text1 和 Text 的绑定是双向的,输入框变化时,text1 随之变化,如果主动变更 text1 的值,输入框也会更新。
通过 .textFieldStyle 方法可以改变 TextField 的样式,效果见示例。
> 查看示例
iOS 16/macOS 13 开始,TextField 还支持文本的自动扩充,由参数 axis 指定水平/垂直方向。比如:
|
|
如果输入框有多行内容,TextField 会自动在 .vertical 方向上扩充,但最多三行,超过三行的内容可以滑动呈现。
此外,TextField 还能便捷地进行格式转换:
|
|
如上代码用于将输入文字转换成数字,需注意的是,当输入框失去焦点结束编辑时,才会触发格式转换,而且只有转换成功时,才会更新相应的值。
状态监听、键盘处理
onSubmit(of:_:) 可以监听键盘的回车事件:
|
|
of 参数是可选的,默认值是 .text ,表示监听的是 TextField 的回车事件。另一个可选的值是 .search,表示监听搜索栏的回车事件,后文介绍滑动视图中使用 .searchable 构建搜索栏时会使用到。
如果一个视图中有多个 TextField,其中一个不想被监听回车事件,可以调用 .submitScope() 进行显示声明。
要更改回车按键的样式,可以使用 submitLabel(_:) 。
键盘的隐藏有三种方式:
-
使用 @FocusState。
在 《SwiftUI 中的属性包装器》 中就详细介绍过 @FocusState 的使用了,本文也增加了一个示例供参考。
-
在滑动视图中使用 .scrollDismissesKeyboard。
当滑动视图时,键盘会消失,消失的策略有好几种,效果见示例。这里说明一下
.interactively这一策略的作用,滑动视图时,只有 TextField 移除屏幕显示区域时,才会触发键盘的消失。 -
使用 UIKit 中的全局通知。
将以下代码封装成方法供全局调用:
1 2 3 4 5 6#if canImport(UIKit) UIApplication.shared.sendAction( #selector(UIResponder.resignFirstResponder), to: nil, from: nil, for: nil ) #endif
SecureField
SecureField 用于输入密码的场景,以上提到以及未提到的 TextField 的方法都适用于它。
TextEditor
理解了TextEditor 使用较为简单,此处略过。
示例实现的是一个具有 placeholder 的 TextEditor,供参考。
> 查看示例