Flutter组件TextFields属性

568 阅读2分钟

属性

  • controller:文本控制器
  • focusNode:获取键盘焦点
  • decoration:InputDecoration 边框装饰
  • inputType:keyboardType 键盘类型
  • textInputAction:键盘的操作按钮类型
  • textCapitalization:TextCapitalization.none 配置大小写键盘
  • style:输入文本样式
  • textAlign:TextAlign.start 对齐方式
  • textDirection:文本方向
  • readOnly:只读
  • showCursor:显示光标
  • autofocus = false:是否自动对焦
  • obscureText:是否隐藏内容,例如密码格式
  • obscuringCharacter:隐藏格式
  • autocorrect = true:是否自动校正
  • maxLines:最大行数
  • minLines:最小行数
  • maxLength:允许输入的最大长度
  • maxLengthEnforced = true:是否允许超过输入最大长度
  • onChanged:文本内容变更时回调 内容改变的时候触发,返回输入框中的内容
  • onEditingComplete:提交内容时回调 回车触发,无参数返回,一般情况跟onSubmitted一起触发
  • TextEditingController
  • onSubmitted:用户提示完成时回调 回车触发,返回输入框中的内容
  • inputFormatters:验证及格式
  • enabled:是否不可点击
  • cursorWidth = 2.0:光标宽度
  • cursorRadius:光标圆角弧度
  • cursorColor:光标颜色
  • keyboardAppearance:键盘亮度,仅限于 iOS 设备
  • scrollPadding:EdgeInsets.all(20.0) 滚动到视图中时,填充边距
  • enableInteractiveSelection:长按是否展示【剪切/复制/粘贴菜单LengthLimitingTextInputFormatter】
  • onTap:点击时回调
  • scrollController:滑动控制器
  • scrollPhysics:滑动样式

InputDecoration属性

  • icon:输入框最前面的widget
  • labelText:悬浮提示文本
  • labelStyle:悬浮提示文本样式
  • helperText:帮助文本
  • helperStyle:帮助文本样式
  • helperMaxLines:帮助文本最大行数
  • hintText:提示文本
  • hintStyle:提示文本样式
  • hintMaxLines:提示文本最大行数
  • errorText:报错文本
  • errorStyle:报错文本样式
  • errorMaxLines:报错文本最大行数
  • isCollapsed:false,是否折叠
  • contentPadding:内边距
  • prefixIcon:前缀widget
  • prefixIconConstraints:prefixIcon约束
  • prefix:前缀widget,相当于自定义前缀widget,整体替换prefixIcon,prefixText(不可跟prefixIcon,prefixText同时使用)
  • prefixText:前缀文本
  • prefixStyle:前缀文本样式
  • suffixIcon:后缀widget
  • suffix:后缀widget,相当于自定义后缀widget,整体替换suffixText,suffixIcon(不可跟suffixText,suffixIcon同时使用)
  • suffixText:后缀文本
  • suffixStyle:后缀文本样式
  • suffixIconConstraints:suffixIcon约束
  • counter:counter widget(在组件右下方,可以自定义功能,不只是计数使用)
  • counterText:counter文本
  • counterStyle:counter文本样式
  • filled:输入框颜色是否填充
  • fillColor:输入框填充色
  • errorBorder:错误边框
  • focusedBorder:获取光标时边框
  • focusedErrorBorder:获取光标时错误边框
  • disabledBorder:不可用时边框
  • enabledBorder:可用时边框
  • border:边框
  • enabled:true,是否可用
  • alignLabelWithHint:label是否对齐hint

inputFormatters输入过滤

  • LengthLimitingTextInputFormatter 限制最长字符;

  • FilteringTextInputFormatter.allow 白名单 (只能输入白名单里的字符)里边是正则

  • FilteringTextInputFormatter.deny 黑名单 里边是正则

  • WhitelistingTextInputFormatter 和 BlacklistingTextInputFormatter 在新的flutter版本里已经废弃了