欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

flutter TextField 属性详细分析

程序员文章站 2022-03-10 22:07:14
...

flutter TextField 属性 简单的进行了归纳,有些是仅凭字面翻译。
flutter TextField中的InputDecoration属性

TextField({
    Key key,
    this.controller, // 编辑框的控制器,通过它可以设置/获取编辑框的内容、
    //选择编辑内容、监听编辑文本改变事件。
    //大多数情况下我们都需要显式提供一个controller来与文本框交互。
    //如果没有提供controller,则TextField内部会自动创建一个。
    
    this.focusNode, //用于控制TextField是否占有当前键盘的输入焦点。
    
    this.decoration = const InputDecoration(), //用于控制TextField的外观显示,
    //如提示文本、背景颜色、边框等
    
    TextInputType keyboardType, //输入的类型
    
    this.textInputAction,//文字输入动作
    
      //characters 默认为每个字符使用大写键盘
      //sentence 默认为每个句子的第一个字母使用大写键盘
      //word 默认为每个单词的第一个字母使用大写键盘。
      //none 默认使用小写
    this.textCapitalization = TextCapitalization.none, //文字大写
    
    this.style, //正在编辑的文本样式
    this.strutStyle, //行风格strutStyle为构造方法的可选参数,
    //用来指定行风格,如行高、行间距,构造器
    
    this.textAlign = TextAlign.start,  //输入框内编辑文本在水平方向的对齐方式。(即光标初始位置)
    
    this.textAlignVertical, //基线对齐
    
    this.textDirection,//文本方向
    
    this.readOnly = false,//是否只读文本
    
    ToolbarOptions toolbarOptions, //工具栏选项
    
    this.showCursor,//显示光标
    
    this.autofocus = false,//是否自动获取焦点
    
    this.obscureText = false,  //是否隐藏正在编辑的文本,
    //如用于输入密码的场景等,文本内容会用“•”替换。
    
    this.autocorrect = true, //自动更正
    
    SmartDashesType smartDashesType, 

    
    this.enableSuggestions = true, //启用建议
    
    this.maxLines = 1, //输入框的最大行数,默认为1;如果为null,则无行数限制
    this.minLines,
    
    this.expands = false,//扩大
    
    this.maxLength, //代表输入框文本的最大长度,设置后输入框右下角会显示输入的文本计数
    
    this.maxLengthEnforced = true,//决定当输入文本长度超过maxLength时是否阻止输入,
    //为true时会阻止输入,为false时不会阻止输入但输入框会变红
    
    this.onChanged,//输入框内容改变时的回调函数;注:内容改变事件也可以通过controller来监听。
    
    this.onEditingComplete, //按回车时调用
    this.onSubmitted,  //内容提交(按回车)的回调
    //onEditingComplete和onSubmitted:这两个回调都是在输入框输入完成时触发,
    //比如按了键盘的完成键(对号图标)或搜索键(????图标)。
    //不同的是两个回调签名不同,onSubmitted回调是ValueChanged<String>类型,
    //它接收当前输入内容做为参数,而onEditingComplete不接收参数。
    
    this.inputFormatters, //用于指定输入格式;当用户输入内容改变时,会根据指定的格式来校验
    
    this.cursorWidth = 2.0, //宽度
    this.cursorRadius, //圆角
    this.cursorColor, //光标颜色
    //cursorWidth、cursorRadius和cursorColor:
    //这三个属性是用于自定义输入框光标宽度、圆角和颜色的。
    
    this.selectionHeightStyle = ui.BoxHeightStyle.tight, 
    this.selectionWidthStyle = ui.BoxWidthStyle.tight,
    
    this.keyboardAppearance,
    
    this.scrollPadding = const EdgeInsets.all(20.0), //滚动填充
    
    this.dragStartBehavior = DragStartBehavior.start, //滚动位置
    
    this.enableInteractiveSelection = true, //启用互动选择
    
    this.onTap,  //点击事件
    
    this.buildCounter, //建立计数器
    
    this.scrollController, //滚动监听
    
    this.scrollPhysics, //滚动事件
  }

keyboardType:用于设置该输入框默认的键盘输入类型,取值如下:
flutter TextField 属性详细分析

flutter TextField中的InputDecoration属性

相关标签: flutter 随笔