NumericTextBox Overview
The NumericTextBox lets the user edit and submit specific numeric values by typing or by using the spin buttons.
Basic Usage
The following example demonstrates the NumericTextBox in action.
class App extends React.Component {
constructor(props) {
super(props);
this.state = {
value: null
};
}
ChangeKilometers = (e) => {
this.setState({
value: e.value
});
}
ChangeMiles = (e) => {
this.setState({
value: e.value !== null ? e.value * 1.609344 : null
});
}
render() {
return (
<div>
<label>
<NumericTextBox
placeholder="please enter value"
value={this.state.value}
onChange={this.ChangeKilometers}
/> Kilometers
</label>
<br />
<label>
<NumericTextBox
placeholder="please enter value"
value={this.state.value == null ? null : this.state.value / 1.609344}
onChange={this.ChangeMiles}
/> Miles
</label>
</div>
);
}
}
ReactDOM.render(
<App />,
document.querySelector('my-app')
);Functionality and Features
- Predefined steps
- Spin buttons
- Formats
- Custom parsing and formatting of user input
- Floating labels
- Keyboard navigation
- Accessibility
Known Limitations
To keep its value, the NumericTextBox uses the Number JavaScript object. The Number JavaScript object persists its precision up to 16 digits, and units which are longer than that get converted to exponential numbers and lose their precision. Because the component relies on Number, it inherits the precision limitation and because the limitation is caused by the JavaScript logic, the NumericTextBox does not provide a workaround to handle it.