mirror of
https://github.com/zhigang1992/react-native.git
synced 2026-02-02 09:08:58 +08:00
Summary: This introduces event counts to make sure JS doesn't set out of date values on native text inputs, which can cause dropped characters and can mess with autocomplete, and obviates the need for the input buffering which added lag and complexity to the component. Made sure to test simulated super-slow JS text event processing to make sure characters aren't dropped, as well as typing obviously correctable words and making sure autocomplete works as expected. TextInput is now a controlled input by default without causing any issues for most cases, so I removed the `controlled` prop. Fixes selection state jumping by restoring it after setting new text values, so highlighting the middle of some text in the new ReWrite example and hitting space will replace that selection with an underscore and keep the cursor at a sensible position as expected, instead of jumping to the end. Ads `maxLength` prop to support the most commonly needed syncronous behavior: preventing the user from typing too many characters. It can also be used to prevent users from continuing to type after entering special characters by changing it to the current length after a regex match. Made sure to verify it works well with pasted input (including in the middle of existing text), truncating it and collapsing the selection the same way it does on the web. Fixes bug in TextEventsExample where it wouldn't show the submit and end events, even though there were firing correctly.
442 lines
10 KiB
JavaScript
442 lines
10 KiB
JavaScript
/**
|
|
* The examples provided by Facebook are for non-commercial testing and
|
|
* evaluation purposes only.
|
|
*
|
|
* Facebook reserves all rights not expressly granted.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
|
|
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NON INFRINGEMENT. IN NO EVENT SHALL
|
|
* FACEBOOK BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
|
|
* AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
* CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
* @flow
|
|
*/
|
|
'use strict';
|
|
|
|
var React = require('react-native');
|
|
var {
|
|
Text,
|
|
TextInput,
|
|
View,
|
|
StyleSheet,
|
|
} = React;
|
|
|
|
var WithLabel = React.createClass({
|
|
render: function() {
|
|
return (
|
|
<View style={styles.labelContainer}>
|
|
<View style={styles.label}>
|
|
<Text>{this.props.label}</Text>
|
|
</View>
|
|
{this.props.children}
|
|
</View>
|
|
);
|
|
},
|
|
});
|
|
|
|
var TextEventsExample = React.createClass({
|
|
getInitialState: function() {
|
|
return {
|
|
curText: '<No Event>',
|
|
prevText: '<No Event>',
|
|
prev2Text: '<No Event>',
|
|
};
|
|
},
|
|
|
|
updateText: function(text) {
|
|
this.setState((state) => {
|
|
return {
|
|
curText: text,
|
|
prevText: state.curText,
|
|
prev2Text: state.prevText,
|
|
};
|
|
});
|
|
},
|
|
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<TextInput
|
|
autoCapitalize="none"
|
|
placeholder="Enter text to see events"
|
|
autoCorrect={false}
|
|
onFocus={() => this.updateText('onFocus')}
|
|
onBlur={() => this.updateText('onBlur')}
|
|
onChange={(event) => this.updateText(
|
|
'onChange text: ' + event.nativeEvent.text
|
|
)}
|
|
onEndEditing={(event) => this.updateText(
|
|
'onEndEditing text: ' + event.nativeEvent.text
|
|
)}
|
|
onSubmitEditing={(event) => this.updateText(
|
|
'onSubmitEditing text: ' + event.nativeEvent.text
|
|
)}
|
|
style={styles.default}
|
|
/>
|
|
<Text style={styles.eventLabel}>
|
|
{this.state.curText}{'\n'}
|
|
(prev: {this.state.prevText}){'\n'}
|
|
(prev2: {this.state.prev2Text})
|
|
</Text>
|
|
</View>
|
|
);
|
|
}
|
|
});
|
|
|
|
class RewriteExample extends React.Component {
|
|
constructor(props) {
|
|
super(props);
|
|
this.state = {text: ''};
|
|
}
|
|
render() {
|
|
var limit = 20;
|
|
var remainder = limit - this.state.text.length;
|
|
var remainderColor = remainder > 5 ? 'blue' : 'red';
|
|
return (
|
|
<View style={styles.rewriteContainer}>
|
|
<TextInput
|
|
multiline={false}
|
|
maxLength={limit}
|
|
onChangeText={(text) => {
|
|
text = text.replace(/ /g, '_');
|
|
this.setState({text});
|
|
}}
|
|
style={styles.default}
|
|
value={this.state.text}
|
|
/>
|
|
<Text style={[styles.remainder, {color: remainderColor}]}>
|
|
{remainder}
|
|
</Text>
|
|
</View>
|
|
);
|
|
}
|
|
}
|
|
|
|
var styles = StyleSheet.create({
|
|
page: {
|
|
paddingBottom: 300,
|
|
},
|
|
default: {
|
|
height: 26,
|
|
borderWidth: 0.5,
|
|
borderColor: '#0f0f0f',
|
|
flex: 1,
|
|
fontSize: 13,
|
|
padding: 4,
|
|
},
|
|
multiline: {
|
|
borderWidth: 0.5,
|
|
borderColor: '#0f0f0f',
|
|
flex: 1,
|
|
fontSize: 13,
|
|
height: 50,
|
|
padding: 4,
|
|
marginBottom: 4,
|
|
},
|
|
multilineWithFontStyles: {
|
|
color: 'blue',
|
|
fontWeight: 'bold',
|
|
fontSize: 18,
|
|
fontFamily: 'Cochin',
|
|
height: 60,
|
|
},
|
|
multilineChild: {
|
|
width: 50,
|
|
height: 40,
|
|
position: 'absolute',
|
|
right: 5,
|
|
backgroundColor: 'red',
|
|
},
|
|
eventLabel: {
|
|
margin: 3,
|
|
fontSize: 12,
|
|
},
|
|
labelContainer: {
|
|
flexDirection: 'row',
|
|
marginVertical: 2,
|
|
flex: 1,
|
|
},
|
|
label: {
|
|
width: 115,
|
|
alignItems: 'flex-end',
|
|
marginRight: 10,
|
|
paddingTop: 2,
|
|
},
|
|
rewriteContainer: {
|
|
flexDirection: 'row',
|
|
alignItems: 'center',
|
|
},
|
|
remainder: {
|
|
textAlign: 'right',
|
|
width: 24,
|
|
},
|
|
});
|
|
|
|
exports.displayName = (undefined: ?string);
|
|
exports.title = '<TextInput>';
|
|
exports.description = 'Single and multi-line text inputs.';
|
|
exports.examples = [
|
|
{
|
|
title: 'Auto-focus',
|
|
render: function() {
|
|
return <TextInput autoFocus={true} style={styles.default} />;
|
|
}
|
|
},
|
|
{
|
|
title: "Live Re-Write (<sp> -> '_') + maxLength",
|
|
render: function() {
|
|
return <RewriteExample />;
|
|
}
|
|
},
|
|
{
|
|
title: 'Auto-capitalize',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<WithLabel label="none">
|
|
<TextInput
|
|
autoCapitalize="none"
|
|
style={styles.default}
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="sentences">
|
|
<TextInput
|
|
autoCapitalize="sentences"
|
|
style={styles.default}
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="words">
|
|
<TextInput
|
|
autoCapitalize="words"
|
|
style={styles.default}
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="characters">
|
|
<TextInput
|
|
autoCapitalize="characters"
|
|
style={styles.default}
|
|
/>
|
|
</WithLabel>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Auto-correct',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<WithLabel label="true">
|
|
<TextInput autoCorrect={true} style={styles.default} />
|
|
</WithLabel>
|
|
<WithLabel label="false">
|
|
<TextInput autoCorrect={false} style={styles.default} />
|
|
</WithLabel>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Keyboard types',
|
|
render: function() {
|
|
var keyboardTypes = [
|
|
'default',
|
|
'ascii-capable',
|
|
'numbers-and-punctuation',
|
|
'url',
|
|
'number-pad',
|
|
'phone-pad',
|
|
'name-phone-pad',
|
|
'email-address',
|
|
'decimal-pad',
|
|
'twitter',
|
|
'web-search',
|
|
'numeric',
|
|
];
|
|
var examples = keyboardTypes.map((type) => {
|
|
return (
|
|
<WithLabel key={type} label={type}>
|
|
<TextInput
|
|
keyboardType={type}
|
|
style={styles.default}
|
|
/>
|
|
</WithLabel>
|
|
);
|
|
});
|
|
return <View>{examples}</View>;
|
|
}
|
|
},
|
|
{
|
|
title: 'Return key types',
|
|
render: function() {
|
|
var returnKeyTypes = [
|
|
'default',
|
|
'go',
|
|
'google',
|
|
'join',
|
|
'next',
|
|
'route',
|
|
'search',
|
|
'send',
|
|
'yahoo',
|
|
'done',
|
|
'emergency-call',
|
|
];
|
|
var examples = returnKeyTypes.map((type) => {
|
|
return (
|
|
<WithLabel key={type} label={type}>
|
|
<TextInput
|
|
returnKeyType={type}
|
|
style={styles.default}
|
|
/>
|
|
</WithLabel>
|
|
);
|
|
});
|
|
return <View>{examples}</View>;
|
|
}
|
|
},
|
|
{
|
|
title: 'Enable return key automatically',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<WithLabel label="true">
|
|
<TextInput enablesReturnKeyAutomatically={true} style={styles.default} />
|
|
</WithLabel>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Secure text entry',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<WithLabel label="true">
|
|
<TextInput password={true} style={styles.default} value="abc" />
|
|
</WithLabel>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Event handling',
|
|
render: function(): ReactElement { return <TextEventsExample />; },
|
|
},
|
|
{
|
|
title: 'Colored input text',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<TextInput
|
|
style={[styles.default, {color: 'blue'}]}
|
|
value="Blue"
|
|
/>
|
|
<TextInput
|
|
style={[styles.default, {color: 'green'}]}
|
|
value="Green"
|
|
/>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Clear button mode',
|
|
render: function () {
|
|
return (
|
|
<View>
|
|
<WithLabel label="never">
|
|
<TextInput
|
|
style={styles.default}
|
|
clearButtonMode="never"
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="while editing">
|
|
<TextInput
|
|
style={styles.default}
|
|
clearButtonMode="while-editing"
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="unless editing">
|
|
<TextInput
|
|
style={styles.default}
|
|
clearButtonMode="unless-editing"
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="always">
|
|
<TextInput
|
|
style={styles.default}
|
|
clearButtonMode="always"
|
|
/>
|
|
</WithLabel>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Clear and select',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<WithLabel label="clearTextOnFocus">
|
|
<TextInput
|
|
placeholder="text is cleared on focus"
|
|
value="text is cleared on focus"
|
|
style={styles.default}
|
|
clearTextOnFocus={true}
|
|
/>
|
|
</WithLabel>
|
|
<WithLabel label="selectTextOnFocus">
|
|
<TextInput
|
|
placeholder="text is selected on focus"
|
|
value="text is selected on focus"
|
|
style={styles.default}
|
|
selectTextOnFocus={true}
|
|
/>
|
|
</WithLabel>
|
|
</View>
|
|
);
|
|
}
|
|
},
|
|
{
|
|
title: 'Multiline',
|
|
render: function() {
|
|
return (
|
|
<View>
|
|
<TextInput
|
|
placeholder="multiline text input"
|
|
multiline={true}
|
|
style={styles.multiline}
|
|
/>
|
|
<TextInput
|
|
placeholder="mutliline text input with font styles and placeholder"
|
|
multiline={true}
|
|
clearTextOnFocus={true}
|
|
autoCorrect={true}
|
|
autoCapitalize="words"
|
|
placeholderTextColor="red"
|
|
keyboardType="url"
|
|
style={[styles.multiline, styles.multilineWithFontStyles]}
|
|
/>
|
|
<TextInput
|
|
placeholder="uneditable mutliline text input"
|
|
editable={false}
|
|
multiline={true}
|
|
style={styles.multiline}
|
|
/>
|
|
<TextInput
|
|
placeholder="multiline with children"
|
|
multiline={true}
|
|
enablesReturnKeyAutomatically={true}
|
|
returnKeyType="go"
|
|
style={styles.multiline}>
|
|
<View style={styles.multilineChild}/>
|
|
</TextInput>
|
|
</View>
|
|
);
|
|
}
|
|
}
|
|
];
|