搜索插件、代码仓与 APP 分类

flutter_native_text_input 封面
插件详情v2.4.0

flutter_native_text_input

Flutter 的原生文本输入。目前仅限 iOS,使用 UITextView。

AndroidiOS
近 30 天下载
226
喜欢数
73
Pub 分数
140

安装插件

flutter pub add flutter_native_text_input

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个提供原生文本输入功能的 Flutter 包,目前仅适用于 iOS,使用 UITextView。通过利用平台特定组件,该包可实现更准确且性能更高的文本输入,从而提升 iOS 设备上的打字体验。虽然该包旨在同时支持 Android 和 iOS,但当前实现仅限于 iOS。这使开发者能够访问 Flutter 默认文本字段未完全支持的原生键盘行为和输入功能。

适合场景

  • 提升iOS文本输入性能
  • 集成原生键盘行为
  • 提高iOS上文本字段的响应性
  • 在 iOS 上使用高级文本输入功能
  • 使用原生样式的文本输入构建表单

主要特点

  • 仅限 iOS 的原生文本输入通过 UITextView
  • 提高打字准确性和速度
  • 利用平台特定的输入方法
  • 支持iOS键盘自定义
  • 专为高性能文本输入设计

适合对象

  • 面向iOS的Flutter应用
  • 需要精确文本输入的应用程序
  • 寻求原生键盘行为的开发者
  • iOS 上的表单密集型应用
  • 需要更好文本字段性能的项目

使用建议

  • Android 尚未提供
  • 目前仅限iOS平台
  • 可能需要额外的 iOS 特定配置
  • 依赖原生 UIKit 组件
  • 与未来 Flutter 更新的潜在兼容性问题

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Native Text Input for Flutter

A text input widget built using the native UITextView on iOS and EditText on Android. For text view, please refer to flutter-native-text-view.

Android support is added in v2 🎉🎉🎉

For existing project(s) using v1, please refer to migration guide here.

Installation

Follow the instructions from https://pub.dev/packages/flutter_native_text_input/install

Why you should use this

Many mobile app users are used to the subtle features provided by the native iOS or Android systems. Even though Flutter provides a lot of useful widgets, many Flutter developers will notice that TextField or CupertinoTextField provided by Flutter are not on par with their native counterpart.

The above shows just one of the missing text editing features in Flutter's TextField, when comparing to the native iOS UITextView. Features like these are especially important if you're building an app that involves a lot of text composition (messaging, editing document, and so on).

To address this, this package simply wraps the native UITextView (and EditText for Android) as a Flutter widget.

Hope you find it useful and happy coding! 🎉🎉🎉

Plugin API

Name Type Description Default
controller TextEditingController Controlling the text being edited (https://api.flutter.dev/flutter/material/TextField/controller.html) null
decoration BoxDecoration Controls the BoxDecoration of the box behind the text input (https://api.flutter.dev/flutter/cupertino/CupertinoTextField/decoration.html) null
focusNode FocusNode Defines the keyboard focus for this widget (https://api.flutter.dev/flutter/material/TextField/focusNode.html) null
iosOptions IosOptions iOS only options (cursorColor, keyboardAppearance) null
keyboardType KeyboardType Type of keyboard to display for a given text-based view (https://developer.apple.com/documentation/uikit/uikeyboardtype) KeyboardType.defaultType
maxLines int The maximum number of lines to show at one time, wrapping if necessary (https://api.flutter.dev/flutter/material/TextField/maxLines.html) 1
minHeightPadding double Extra vertical spacing added in addition to line height for iOS UITextView to fit well in single line mode 18.0
minLines int Minimum number of lines of text input widget 1
placeholder String Placeholder text when text entry is empty (https://api.flutter.dev/flutter/cupertino/CupertinoTextField/placeholder.html) null
placeholderColor Color The text color to use for the placeholder text null
returnKeyType ReturnKeyType Constants that specify the text string that displays in the Return key of a keyboard (https://developer.apple.com/documentation/uikit/uireturnkeytype) ReturnKeyType.defaultAction
style TextStyle The style to use for the text being edited [Only fontSize, fontWeight, color are supported] (https://api.flutter.dev/flutter/material/TextField/style.html) null
textAlign TextAlign How the text should be aligned horizontally (https://api.flutter.dev/flutter/material/TextField/textAlign.html) TextAlign.start
textCapitalization TextCapitalization Configures how the platform keyboard will select an uppercase or lowercase keyboard (https://api.flutter.dev/flutter/material/TextField/textCapitalization.html) TextCapitalization.none
textContentType TextContentType To identify the semantic meaning expected for a text-entry area (https://developer.apple.com/documentation/uikit/uitextcontenttype) null
onChanged ValueChanged<String> Called when the user initiates a change to text entry (https://api.flutter.dev/flutter/material/TextField/onChanged.html) null
onEditingComplete VoidCallback? Called when the user submits editable content (e.g., user presses the "done" button on the keyboard) (https://api.flutter.dev/flutter/material/TextField/onEditingComplete.html) null
onSubmitted ValueChanged<String> Called when the user indicates that they are done editing the text in the field (https://api.flutter.dev/flutter/material/TextField/onSubmitted.html) null
IosOptions
Name Type Description Default
cursorColor Color The color of the cursor (https://api.flutter.dev/flutter/material/TextField/cursorColor.html) null
keyboardAppearance Brightness The appearance of the keyboard (https://api.flutter.dev/flutter/material/TextField/keyboardAppearance.html) null
placeholderStyle TextStyle The style to use for the placeholder text. [Only fontSize, fontWeight are supported] (https://api.flutter.dev/flutter/cupertino/CupertinoTextField/placeholderStyle.html) null

More examples

You may find more usage examples here.

Contributing

Found a bug?

Please do not hestitate to report that. This cuuld help improve this package.

Feature request?

Please feel free to create an issue.

Pull request?

Contributors are welcome. Just create a PR and it would be reviewed and merged ASAP.

If you enjoy using this package or it helps you or your team, you could also buy me a cup of coffee to show support :)

https://PayPal.Me/hkhenryleung/50

License

This project is licensed under the MIT License.

所属分类

源码仓库

使用此插件的项目

暂无相关数据。