Skip to content

UISearchBar:enablesReturnKeyAutomatically 属性 ​

enablesReturnKeyAutomatically 属性设置没有内容时回车键是否变灰。它是搜索框的九个键盘设置之一。

值 ​

布尔。

取值效果
true没有内容时回车键变灰、不能按
false回车键一直能按
  • 可读,可写。
  • 默认值是 true。新建的 UITextField 是 false。
  • 写别的类型的值时按真假转成布尔。
  • 和 searchTextField 上的同名属性是同一份设置:写哪一边,另一边都读得到。
  • 没有变化事件:改它的只有 App 的代码,写搜索框的属性或者写 searchTextField 上的同名属性。
  • 默认值和读写在模拟器(iPhone Air,iOS 27.2)和真机(iPhone 14)上验证过。

示例 ​

js
const search = new UISearchBar();
search.enablesReturnKeyAutomatically = false;
console.log(search.searchTextField.enablesReturnKeyAutomatically);

效果:没有输入内容时也能按「搜索」。**未在模拟器验证。**控制台输出新写入的值。

对应的 iOS API ​

UISearchBar.enablesReturnKeyAutomatically。

参见 ​