CupertinoTextField 仿生了 iOS 原生系统中的 UITextField 组件，该组件用于创建输入框。
值得注意的是，Flutter 几乎把整个 iOS 键盘输入特性搬了过来，包括长按空格键移动光标这一牛逼特性。你可以使用此 widget 实现几乎仿真 iOS 的交互体验，最后不要忘记释放 TextEditingController。
前往 UITextField 了解更多关于 iOS 原生
UITextField的详细内容。
需要使用此特性，您需要在工程文件的头部引入 package:flutter/cupertino.dart。
CupertinoSwitch 构造函数的实现如下。
const CupertinoTextField({
Key key,
TextEditingController controller,
FocusNode focusNode,
BoxDecoration decoration: _kDefaultRoundedBorderDecoration,
EdgeInsetsGeometry padding: const EdgeInsets.all(6.0),
String placeholder,
TextStyle placeholderStyle: const TextStyle(fontWeight: FontWeight.w300, color: _kInactiveTextColor),
Widget prefix,
OverlayVisibilityMode prefixMode: OverlayVisibilityMode.always,
Widget suffix,
OverlayVisibilityMode suffixMode: OverlayVisibilityMode.always,
OverlayVisibilityMode clearButtonMode: OverlayVisibilityMode.never,
TextInputType keyboardType,
TextInputAction textInputAction,
TextCapitalization textCapitalization: TextCapitalization.none,
TextStyle style,
StrutStyle strutStyle,
TextAlign textAlign: TextAlign.start,
bool readOnly: false,
bool showCursor,
bool autofocus: false,
bool obscureText: false,
bool autocorrect: true,
int maxLines: 1,
int minLines,
bool expands: false,
int maxLength,
bool maxLengthEnforced: true,
ValueChanged<String> onChanged,
VoidCallback onEditingComplete,
ValueChanged<String> onSubmitted,
List<TextInputFormatter> inputFormatters,
bool enabled,
double cursorWidth: 2.0,
Radius cursorRadius: const Radius.circular(2.0),
Color cursorColor,
Brightness keyboardAppearance,
EdgeInsets scrollPadding: const EdgeInsets.all(20.0),
DragStartBehavior dragStartBehavior: DragStartBehavior.start,
bool enableInteractiveSelection,
ScrollController scrollController,
ScrollPhysics scrollPhysics
})
-
autocorrect是否启用语法自动修正。 -
autofocus当文本框获得焦点时，是否自动弹出键盘。否则只有用户点击时才会弹出。 -
clearButtonMode在空间尾部增加一个清除按钮。 -
controller文本的输入控制器。如果你有需要监听用户的输入行为，则需要自定义。 -
cursorColor光标的颜色。 -
cursorRadius光标的圆角半径。 -
cursorWidth光标的宽度。 -
decoration控件文本输入后框的框装饰。默认情况下有一个圆角矩形灰色边框，可以为空。 -
enabled如果为 false 则为禁用此输入框，并且背景为灰色。此时 touch 事件都将不会响应。 -
enableInteractiveSelection默认为 true，用户可以长按文字进行复制粘贴等操作。反之为 false。 -
inputFormatters提供你的格式验证和重写算法。widget 会依照你所提供的顺序执行。 -
keyboardAppearance键盘的外观，仅 iOS 可用。 -
keyboardType键盘的类型。 -
maxLength最大允许的字符数。 -
maxLengthEnforced如果为 true，则强行阻止其超过最大数限制，否则仅仅是警告。默认为 false。 -
maxLines为最大允许的行数，minLines则为最小允许的行数。 -
obscureText是否使用隐藏文本。例如，输入密码时。 -
onChanged当文本发生变化时回调。 -
onEditingComplete当用户按下键盘的「完成（Done）」时回调。 -
placeholder当文本框无内容时的浅色占位符。 -
placeholderStyle浅色占位符的样式。 -
prefix在文本框头部显示的前缀小控件，prefixMode设置前缀小控件的显示方式。 -
readOnly此编辑框是否仅仅是只读的模式。 -
showCursor光标是否显示。 -
suffix在文本框尾部显示的后缀小控件，suffixMode设置后缀小控件的显示方式。 -
textAlign在水平的方向上，文本要以何种方式对齐。 -
textCapitalization指定键盘的大小写显示模式。 -
textInputAction键盘右下角的「Enter」按钮应当显示什么文字。例如，「完成」，「加入」等样式。
此 demo 完整实例如下。
class MyPrefilledText extends StatefulWidget {
@override
_MyPrefilledTextState createState() => _MyPrefilledTextState();
}
class _MyPrefilledTextState extends State<MyPrefilledText> {
TextEditingController _textController;
@override
void initState() {
super.initState();
_textController = TextEditingController(text: 'input here!');
}
@override
Widget build(BuildContext context) {
return CupertinoTextField(
clearButtonMode: OverlayVisibilityMode.always,
keyboardAppearance: Brightness.dark,
controller: _textController,
cursorRadius: Radius.circular(40),
cursorWidth: 8,
cursorColor: Color(0xffff0000),
autocorrect: true,
);
}
}