Flow type and codegen for AndroidTextInput
Summary: Flow type for AndroidTextInput. This could theoretically be used for the interface codegen in the future, and I did use this to codegen the scaffolding for AndroidTextInput (see previous diffs). Reviewed By: mdvacca Differential Revision: D16926831 fbshipit-source-id: d01c2e041efb4151f6091dd0fea191989d133881
This commit is contained in:
Родитель
a1ee1d7698
Коммит
ba56fa43f0
|
@ -10,10 +10,561 @@
|
|||
|
||||
'use strict';
|
||||
|
||||
import type {ViewProps} from '../View/ViewPropTypes';
|
||||
import type {
|
||||
BubblingEventHandler,
|
||||
DirectEventHandler,
|
||||
Double,
|
||||
Float,
|
||||
Int32,
|
||||
} from 'react-native/Libraries/Types/CodegenTypes';
|
||||
import type {NativeComponent} from '../../Renderer/shims/ReactNative';
|
||||
import type {TextStyleProp, ViewStyleProp} from '../../StyleSheet/StyleSheet';
|
||||
import type {ColorValue} from '../../StyleSheet/StyleSheetTypes';
|
||||
import {requireNativeComponent} from 'react-native';
|
||||
|
||||
const AndroidTextInputNativeComponent: string = requireNativeComponent(
|
||||
'AndroidTextInput',
|
||||
);
|
||||
/*export type KeyboardType =
|
||||
// Cross Platform
|
||||
| 'default'
|
||||
| 'email-address'
|
||||
| 'numeric'
|
||||
| 'phone-pad'
|
||||
| 'number-pad'
|
||||
| 'decimal-pad'
|
||||
// iOS-only
|
||||
| 'ascii-capable'
|
||||
| 'numbers-and-punctuation'
|
||||
| 'url'
|
||||
| 'name-phone-pad'
|
||||
| 'twitter'
|
||||
| 'web-search'
|
||||
// Android-only
|
||||
| 'visible-password';*/
|
||||
|
||||
export default AndroidTextInputNativeComponent;
|
||||
/*export type ReturnKeyType =
|
||||
// Cross Platform
|
||||
| 'done'
|
||||
| 'go'
|
||||
| 'next'
|
||||
| 'search'
|
||||
| 'send'
|
||||
// Android-only
|
||||
| 'none'
|
||||
| 'previous'
|
||||
// iOS-only
|
||||
| 'default'
|
||||
| 'emergency-call'
|
||||
| 'google'
|
||||
| 'join'
|
||||
| 'route'
|
||||
| 'yahoo';*/
|
||||
|
||||
export type NativeProps = $ReadOnly<{|
|
||||
// This allows us to inherit everything from ViewProps except for style (see below)
|
||||
// This must be commented for Fabric codegen to work.
|
||||
...$Diff<ViewProps, $ReadOnly<{|style: ?ViewStyleProp|}>>,
|
||||
|
||||
/**
|
||||
* Android props after this
|
||||
*/
|
||||
/**
|
||||
* Determines which content to suggest on auto complete, e.g.`username`.
|
||||
* To disable auto complete, use `off`.
|
||||
*
|
||||
* *Android Only*
|
||||
*
|
||||
* The following values work on Android only:
|
||||
*
|
||||
* - `username`
|
||||
* - `password`
|
||||
* - `email`
|
||||
* - `name`
|
||||
* - `tel`
|
||||
* - `street-address`
|
||||
* - `postal-code`
|
||||
* - `cc-number`
|
||||
* - `cc-csc`
|
||||
* - `cc-exp`
|
||||
* - `cc-exp-month`
|
||||
* - `cc-exp-year`
|
||||
* - `off`
|
||||
*
|
||||
* @platform android
|
||||
*/
|
||||
// TODO T53321474: define as flow enum
|
||||
autoCompleteType?: ?string /*WithDefault<
|
||||
?(
|
||||
| 'cc-csc'
|
||||
| 'cc-exp'
|
||||
| 'cc-exp-month'
|
||||
| 'cc-exp-year'
|
||||
| 'cc-number'
|
||||
| 'email'
|
||||
| 'name'
|
||||
| 'password'
|
||||
| 'postal-code'
|
||||
| 'street-address'
|
||||
| 'tel'
|
||||
| 'username'
|
||||
| 'off'
|
||||
),
|
||||
'off',
|
||||
>*/,
|
||||
|
||||
/**
|
||||
* Sets the return key to the label. Use it instead of `returnKeyType`.
|
||||
* @platform android
|
||||
*/
|
||||
returnKeyLabel?: ?string,
|
||||
|
||||
/**
|
||||
* Sets the number of lines for a `TextInput`. Use it with multiline set to
|
||||
* `true` to be able to fill the lines.
|
||||
* @platform android
|
||||
*/
|
||||
numberOfLines?: ?Int32,
|
||||
|
||||
/**
|
||||
* When `false`, if there is a small amount of space available around a text input
|
||||
* (e.g. landscape orientation on a phone), the OS may choose to have the user edit
|
||||
* the text inside of a full screen text input mode. When `true`, this feature is
|
||||
* disabled and users will always edit the text directly inside of the text input.
|
||||
* Defaults to `false`.
|
||||
* @platform android
|
||||
*/
|
||||
disableFullscreenUI?: ?boolean,
|
||||
|
||||
/**
|
||||
* Set text break strategy on Android API Level 23+, possible values are `simple`, `highQuality`, `balanced`
|
||||
* The default value is `simple`.
|
||||
* @platform android
|
||||
*/
|
||||
// TODO T53321474: enable enum types in codegen
|
||||
textBreakStrategy?: string, // ?('simple' | 'highQuality' | 'balanced'),
|
||||
|
||||
/**
|
||||
* The color of the `TextInput` underline.
|
||||
* @platform android
|
||||
*/
|
||||
underlineColorAndroid?: ?ColorValue,
|
||||
|
||||
/**
|
||||
* If defined, the provided image resource will be rendered on the left.
|
||||
* The image resource must be inside `/android/app/src/main/res/drawable` and referenced
|
||||
* like
|
||||
* ```
|
||||
* <TextInput
|
||||
* inlineImageLeft='search_icon'
|
||||
* />
|
||||
* ```
|
||||
* @platform android
|
||||
*/
|
||||
inlineImageLeft?: ?string,
|
||||
|
||||
/**
|
||||
* Padding between the inline image, if any, and the text input itself.
|
||||
* @platform android
|
||||
*/
|
||||
inlineImagePadding?: ?Int32,
|
||||
|
||||
importantForAutofill?: string /*?(
|
||||
| 'auto'
|
||||
| 'no'
|
||||
| 'noExcludeDescendants'
|
||||
| 'yes'
|
||||
| 'yesExcludeDescendants'
|
||||
),*/,
|
||||
|
||||
/**
|
||||
* When `false`, it will prevent the soft keyboard from showing when the field is focused.
|
||||
* Defaults to `true`.
|
||||
* @platform android
|
||||
*/
|
||||
showSoftInputOnFocus?: ?boolean,
|
||||
|
||||
/**
|
||||
* TextInput props after this
|
||||
*/
|
||||
/**
|
||||
* Can tell `TextInput` to automatically capitalize certain characters.
|
||||
*
|
||||
* - `characters`: all characters.
|
||||
* - `words`: first letter of each word.
|
||||
* - `sentences`: first letter of each sentence (*default*).
|
||||
* - `none`: don't auto capitalize anything.
|
||||
*/
|
||||
autoCapitalize?: ?string, // TODO T53321474: define as enum: AutoCapitalize 'none' | 'sentences' | 'words' | 'characters' ,
|
||||
|
||||
/**
|
||||
* If `false`, disables auto-correct. The default value is `true`.
|
||||
*/
|
||||
autoCorrect?: ?boolean,
|
||||
|
||||
/**
|
||||
* If `true`, focuses the input on `componentDidMount`.
|
||||
* The default value is `false`.
|
||||
*/
|
||||
autoFocus?: ?boolean,
|
||||
|
||||
/**
|
||||
* Specifies whether fonts should scale to respect Text Size accessibility settings. The
|
||||
* default is `true`.
|
||||
*/
|
||||
allowFontScaling?: ?boolean,
|
||||
|
||||
/**
|
||||
* Specifies largest possible scale a font can reach when `allowFontScaling` is enabled.
|
||||
* Possible values:
|
||||
* `null/undefined` (default): inherit from the parent node or the global default (0)
|
||||
* `0`: no max, ignore parent/global default
|
||||
* `>= 1`: sets the maxFontSizeMultiplier of this node to this value
|
||||
*/
|
||||
maxFontSizeMultiplier?: ?Float,
|
||||
|
||||
/**
|
||||
* If `false`, text is not editable. The default value is `true`.
|
||||
*/
|
||||
editable?: ?boolean,
|
||||
|
||||
/**
|
||||
* Determines which keyboard to open, e.g.`numeric`.
|
||||
*
|
||||
* The following values work across platforms:
|
||||
*
|
||||
* - `default`
|
||||
* - `numeric`
|
||||
* - `number-pad`
|
||||
* - `decimal-pad`
|
||||
* - `email-address`
|
||||
* - `phone-pad`
|
||||
*
|
||||
* *iOS Only*
|
||||
*
|
||||
* The following values work on iOS only:
|
||||
*
|
||||
* - `ascii-capable`
|
||||
* - `numbers-and-punctuation`
|
||||
* - `url`
|
||||
* - `name-phone-pad`
|
||||
* - `twitter`
|
||||
* - `web-search`
|
||||
*
|
||||
* *Android Only*
|
||||
*
|
||||
* The following values work on Android only:
|
||||
*
|
||||
* - `visible-password`
|
||||
*/
|
||||
// TODO T53321474: enable enum codegen
|
||||
keyboardType?: ?string, // ?KeyboardType,
|
||||
|
||||
/**
|
||||
* Determines how the return key should look. On Android you can also use
|
||||
* `returnKeyLabel`.
|
||||
*
|
||||
* *Cross platform*
|
||||
*
|
||||
* The following values work across platforms:
|
||||
*
|
||||
* - `done`
|
||||
* - `go`
|
||||
* - `next`
|
||||
* - `search`
|
||||
* - `send`
|
||||
*
|
||||
* *Android Only*
|
||||
*
|
||||
* The following values work on Android only:
|
||||
*
|
||||
* - `none`
|
||||
* - `previous`
|
||||
*
|
||||
* *iOS Only*
|
||||
*
|
||||
* The following values work on iOS only:
|
||||
*
|
||||
* - `default`
|
||||
* - `emergency-call`
|
||||
* - `google`
|
||||
* - `join`
|
||||
* - `route`
|
||||
* - `yahoo`
|
||||
*/
|
||||
// TODO T53321474: enable enum codegen
|
||||
returnKeyType?: ?string, // ?ReturnKeyType,
|
||||
|
||||
/**
|
||||
* Limits the maximum number of characters that can be entered. Use this
|
||||
* instead of implementing the logic in JS to avoid flicker.
|
||||
*/
|
||||
maxLength?: ?Int32,
|
||||
|
||||
/**
|
||||
* If `true`, the text input can be multiple lines.
|
||||
* The default value is `false`.
|
||||
*/
|
||||
multiline?: ?boolean,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input is blurred.
|
||||
* `target` is the reactTag of the element
|
||||
*/
|
||||
onBlur?: ?BubblingEventHandler<$ReadOnly<{|target: Int32|}>>,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input is focused.
|
||||
* `target` is the reactTag of the element
|
||||
*/
|
||||
onFocus?: ?BubblingEventHandler<$ReadOnly<{|target: Int32|}>>,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input's text changes.
|
||||
* `target` is the reactTag of the element
|
||||
* TODO: differentiate between onChange and onChangeText
|
||||
*/
|
||||
onChange?: ?BubblingEventHandler<
|
||||
$ReadOnly<{|target: Int32, eventCount: Int32, text: string|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input's text changes.
|
||||
* Changed text is passed as an argument to the callback handler.
|
||||
* TODO: differentiate between onChange and onChangeText
|
||||
*/
|
||||
onChangeText?: ?BubblingEventHandler<
|
||||
$ReadOnly<{|target: Int32, eventCount: Int32, text: string|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input's content size changes.
|
||||
* This will be called with
|
||||
* `{ nativeEvent: { contentSize: { width, height } } }`.
|
||||
*
|
||||
* Only called for multiline text inputs.
|
||||
*/
|
||||
onContentSizeChange?: ?DirectEventHandler<
|
||||
$ReadOnly<{|
|
||||
target: Int32,
|
||||
// contentSize: $ReadOnly<{|width: Double, height: Double|}>,
|
||||
contentSize: {|width: Double, height: Double|},
|
||||
|}>,
|
||||
>,
|
||||
|
||||
onTextInput?: ?BubblingEventHandler<
|
||||
$ReadOnly<{|
|
||||
target: Int32,
|
||||
text: string,
|
||||
previousText: string,
|
||||
// range: $ReadOnly<{|start: Double, end: Double|}>,
|
||||
range: {|start: Double, end: Double|},
|
||||
|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* Callback that is called when text input ends.
|
||||
*/
|
||||
onEndEditing?: ?BubblingEventHandler<
|
||||
$ReadOnly<{|target: Int32, text: string|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input selection is changed.
|
||||
* This will be called with
|
||||
* `{ nativeEvent: { selection: { start, end } } }`.
|
||||
*/
|
||||
onSelectionChange?: ?DirectEventHandler<
|
||||
$ReadOnly<{|
|
||||
target: Int32,
|
||||
//selection: $ReadOnly<{|start: Double, end: Double|}>,
|
||||
selection: {|start: Double, end: Double|},
|
||||
|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* Callback that is called when the text input's submit button is pressed.
|
||||
* Invalid if `multiline={true}` is specified.
|
||||
*/
|
||||
onSubmitEditing?: ?BubblingEventHandler<
|
||||
$ReadOnly<{|target: Int32, text: string|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* Callback that is called when a key is pressed.
|
||||
* This will be called with `{ nativeEvent: { key: keyValue } }`
|
||||
* where `keyValue` is `'Enter'` or `'Backspace'` for respective keys and
|
||||
* the typed-in character otherwise including `' '` for space.
|
||||
* Fires before `onChange` callbacks.
|
||||
*/
|
||||
onKeyPress?: ?BubblingEventHandler<$ReadOnly<{|target: Int32, key: string|}>>,
|
||||
|
||||
/**
|
||||
* Invoked on content scroll with `{ nativeEvent: { contentOffset: { x, y } } }`.
|
||||
* May also contain other properties from ScrollEvent but on Android contentSize
|
||||
* is not provided for performance reasons.
|
||||
*/
|
||||
onScroll?: ?DirectEventHandler<
|
||||
$ReadOnly<{|
|
||||
target: Int32,
|
||||
responderIgnoreScroll: boolean,
|
||||
contentInset: {|
|
||||
//$ReadOnly<{|
|
||||
top: Double, // always 0 on Android
|
||||
bottom: Double, // always 0 on Android
|
||||
left: Double, // always 0 on Android
|
||||
right: Double, // always 0 on Android
|
||||
|},
|
||||
contentOffset: {|
|
||||
//$ReadOnly<{|
|
||||
x: Double,
|
||||
y: Double,
|
||||
|},
|
||||
contentSize: {|
|
||||
// $ReadOnly<{|
|
||||
width: Double, // always 0 on Android
|
||||
height: Double, // always 0 on Android
|
||||
|},
|
||||
layoutMeasurement: {|
|
||||
// $ReadOnly<{|
|
||||
width: Double,
|
||||
height: Double,
|
||||
|},
|
||||
velocity: {|
|
||||
// $ReadOnly<{|
|
||||
x: Double, // always 0 on Android
|
||||
y: Double, // always 0 on Android
|
||||
|},
|
||||
|}>,
|
||||
>,
|
||||
|
||||
/**
|
||||
* The string that will be rendered before text input has been entered.
|
||||
*/
|
||||
placeholder?: ?string,
|
||||
|
||||
/**
|
||||
* The text color of the placeholder string.
|
||||
*/
|
||||
placeholderTextColor?: ?ColorValue,
|
||||
|
||||
/**
|
||||
* If `true`, the text input obscures the text entered so that sensitive text
|
||||
* like passwords stay secure. The default value is `false`. Does not work with 'multiline={true}'.
|
||||
*/
|
||||
secureTextEntry?: ?boolean,
|
||||
|
||||
/**
|
||||
* The highlight and cursor color of the text input.
|
||||
*/
|
||||
selectionColor?: ?ColorValue,
|
||||
|
||||
/**
|
||||
* The start and end of the text input's selection. Set start and end to
|
||||
* the same value to position the cursor.
|
||||
*/
|
||||
selection?: ?$ReadOnly<{|
|
||||
start: Int32,
|
||||
end?: ?Int32,
|
||||
|}>,
|
||||
|
||||
/**
|
||||
* The value to show for the text input. `TextInput` is a controlled
|
||||
* component, which means the native value will be forced to match this
|
||||
* value prop if provided. For most uses, this works great, but in some
|
||||
* cases this may cause flickering - one common cause is preventing edits
|
||||
* by keeping value the same. In addition to simply setting the same value,
|
||||
* either set `editable={false}`, or set/update `maxLength` to prevent
|
||||
* unwanted edits without flicker.
|
||||
*/
|
||||
value?: ?string,
|
||||
|
||||
/**
|
||||
* Provides an initial value that will change when the user starts typing.
|
||||
* Useful for simple use-cases where you do not want to deal with listening
|
||||
* to events and updating the value prop to keep the controlled state in sync.
|
||||
*/
|
||||
defaultValue?: ?string,
|
||||
|
||||
/**
|
||||
* If `true`, all text will automatically be selected on focus.
|
||||
*/
|
||||
selectTextOnFocus?: ?boolean,
|
||||
|
||||
/**
|
||||
* If `true`, the text field will blur when submitted.
|
||||
* The default value is true for single-line fields and false for
|
||||
* multiline fields. Note that for multiline fields, setting `blurOnSubmit`
|
||||
* to `true` means that pressing return will blur the field and trigger the
|
||||
* `onSubmitEditing` event instead of inserting a newline into the field.
|
||||
*/
|
||||
blurOnSubmit?: ?boolean,
|
||||
|
||||
/**
|
||||
* Note that not all Text styles are supported, an incomplete list of what is not supported includes:
|
||||
*
|
||||
* - `borderLeftWidth`
|
||||
* - `borderTopWidth`
|
||||
* - `borderRightWidth`
|
||||
* - `borderBottomWidth`
|
||||
* - `borderTopLeftRadius`
|
||||
* - `borderTopRightRadius`
|
||||
* - `borderBottomRightRadius`
|
||||
* - `borderBottomLeftRadius`
|
||||
*
|
||||
* see [Issue#7070](https://github.com/facebook/react-native/issues/7070)
|
||||
* for more detail.
|
||||
*
|
||||
* [Styles](docs/style.html)
|
||||
*/
|
||||
// TODO: figure out what to do with this style prop for codegen/Fabric purposes
|
||||
// This must be commented for Fabric codegen to work; it's currently not possible
|
||||
// to override the default View style prop in codegen.
|
||||
style?: ?TextStyleProp,
|
||||
|
||||
/**
|
||||
* If `true`, caret is hidden. The default value is `false`.
|
||||
* This property is supported only for single-line TextInput component on iOS.
|
||||
*/
|
||||
caretHidden?: ?boolean,
|
||||
|
||||
/*
|
||||
* If `true`, contextMenuHidden is hidden. The default value is `false`.
|
||||
*/
|
||||
contextMenuHidden?: ?boolean,
|
||||
|
||||
/**
|
||||
* The following are props that `BaseTextShadowNode` takes. It is unclear if they
|
||||
* are used by TextInput.
|
||||
*/
|
||||
textShadowColor?: ?ColorValue,
|
||||
textShadowRadius?: ?Float,
|
||||
textDecorationLine?: ?string,
|
||||
fontStyle?: ?string,
|
||||
textShadowOffset?: ?$ReadOnly<{|width?: ?Double, height?: ?Double|}>,
|
||||
lineHeight?: ?Float,
|
||||
textTransform?: ?string,
|
||||
color?: ?Int32,
|
||||
letterSpacing?: ?Float,
|
||||
fontSize?: ?Float,
|
||||
textAlign?: ?string,
|
||||
includeFontPadding?: ?boolean,
|
||||
fontWeight?: ?string,
|
||||
fontFamily?: ?string,
|
||||
|
||||
/**
|
||||
* I cannot find where these are defined but JS complains without them.
|
||||
*/
|
||||
textAlignVertical?: ?string,
|
||||
cursorColor?: ?ColorValue,
|
||||
|
||||
/**
|
||||
* "Private" fields used by TextInput.js and not users of this component directly
|
||||
*/
|
||||
mostRecentEventCount: Int32,
|
||||
text?: ?string,
|
||||
|}>;
|
||||
|
||||
type AndroidTextInputComponentType = Class<NativeComponent<NativeProps>>;
|
||||
|
||||
export default ((requireNativeComponent(
|
||||
'AndroidTextInput',
|
||||
): any): AndroidTextInputComponentType);
|
||||
|
|
Загрузка…
Ссылка в новой задаче