react-bootstrap-xeditable
v1.0.0
Published
X-Editable for React with Bootstrap. [Demo](https://yankun.org/react-bootstrap-xeditable/)
Downloads
1,094
Readme
react-bootstrap-xeditable
X-Editable for React with Bootstrap. Demo
Install
# npm
npm install react-bootstrap-xeditable
# yarn
yarn add react-bootstrap-xeditable
import bootstrap css and xeditable css
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css">
<link rel="stylesheet" href="https://vitalets.github.io/x-editable/assets/x-editable/bootstrap3-editable/css/bootstrap-editable.css">
Usage:
TextField
import {EditableTextField} from 'react-bootstrap-xeditable';
<EditableTextField name='username' value={this.state.value} onSave={this.onSave} placeholder='Please input your username'/>
Options
| Option | Type | Required | Description | | ------| ------ | ------ |------ | | isEditing| boolean | optional | Set editing status | | isEditable| boolean | optional | You can make it readonly | | linkClassName| string | optional | Defined the css class for the link text | | nonValueText| string | optional | the default text if no value | | value| string | required | The value of input text | | onSave| function | required | the callback when click save button | | onCancel| function | optional | the callback when click cancel button | | placeholder | string | optional| |
Select
const options = [
{
text: 'China',
value: 'CN'
}, {
text: 'India',
value: 'IN'
}, {
text: 'United Kingdom (UK)',
value: 'UK'
}, {
text: 'United States of America (USA)',
value: 'USA'
}
];
import {EditableSelect} from 'react-bootstrap-xeditable';
<EditableSelect name='country' onSave={this.onSave} value={this.state.value} options={options}/>
Options
| Option | Type | Required | Description | | ------| ------ | ------ |------ | | isEditing| boolean | optional | Set editing status | | isEditable| boolean | optional | You can make it readonly | | linkClassName| string | optional | Defined the css class for the link text | | nonValueText| string | optional | the default text if no value | | value| string | string[] | required | The value of input text | | multiple| boolean | optional | If the select support multiple | | options| IOption[] | string[] | required | The options | | onSave| function | required | the callback when click save button | | onCancel| function | optional | the callback when click cancel button |
TextArea
import {EditableTextArea} from 'react-bootstrap-xeditable';
<EditableTextArea name='username' value={this.state.value} onSave={this.onSave} placeholder='Please input your username'/>
Options
| Option | Type | Required | Description | | ------| ------ | ------ |------ | | isEditing| boolean | optional | Set editing status | | isEditable| boolean | optional | You can make it readonly | | linkClassName| string | optional | Defined the css class for the link text | | nonValueText| string | optional | the default text if no value | | value| string | required | The value of input text | | onSave| function | required | the callback when click save button | | onCancel| function | optional | the callback when click cancel button |
Progress:
- :white_check_mark: : Supported
- :runner: : In Progress
- :thought_balloon: : Planning
| Element | Support | ReactXElement | | ------| ------ | ------ | | textfield| :white_check_mark: | EditableTextField | | select| :white_check_mark: | EditableSelect | | textarea| :white_check_mark: | EditableTextArea | | date| :thought_balloon: | | | datetime| :thought_balloon: | | | select2| :thought_balloon: | |
TypeScript:
d.ts already intergrated. just import it.
Known Issues:
- Only support inline mode
- onBlur not support yet
License
Licensed under the MIT license. Copyright (C) 2018 Kun Yan