현재 iOS용 UITextView를 사용하여 네이티브 텍스트 입력 기능을 제공하는 플러터 패키지입니다. 플랫폼별 구성 요소를 활용함으로써 더 정확하고 성능이 뛰어난 텍스트 입력을 가능하게 하여 iOS 장치에서의 타이핑 경험을 향상시킵니다. 이 패키지는 안드로이드와 iOS 모두에서 작동하도록 설계되었지만 현재 구현은 iOS 전용입니다. 이를 통해 개발자는 플러터 기본 텍스트 필드가 완전히 지원하지 않는 네이티브 키보드 동작 및 입력 기능에 접근할 수 있습니다.
사용 사례
iOS 텍스트 입력 성능 향상
네이티브 키보드 동작 통합
iOS에서 텍스트 필드 반응성 개선
iOS에서 고급 텍스트 입력 기능 사용
네이티브 스타일의 텍스트 입력을 사용하여 양식 만들기
주요 기능
UITextView를 통한 iOS 전용 네이티브 텍스트 입력
타이핑 정확도와 속도 향상
플랫폼 전용 입력 방법을 활용
iOS 키보드 사용자 정의를 지원
고성능 텍스트 입력을 위한 설계
적합한 대상
iOS 중심의 Flutter 앱
정확한 텍스트 입력이 필요한 앱
네이티브 키보드 동작을 원하는 개발자
iOS에서 폼 중심 애플리케이션
더 나은 텍스트 필드 성능이 필요한 프로젝트
고려 사항
안드로이드용으로 아직 이용할 수 없습니다
현재 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)