X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=README.md;h=1c44e76c63df8dddb380b15aecebf5862be07f86;hb=3ab3a128deaf10300b31102b79458528227baa54;hp=40cb7c4df60fe28e43e24c35aaabeea6611c97db;hpb=1f336fabc9135ac971e53d9c2ae407db69b8f096;p=github%2Ffretlink%2Ftime-picker.git diff --git a/README.md b/README.md index 40cb7c4..1c44e76 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,97 @@ -# timepicker -Timepicker +# TimePicker + +React TimePicker + +[![NPM version][npm-image]][npm-url] +[![build status][travis-image]][travis-url] +[![Test coverage][coveralls-image]][coveralls-url] +[![gemnasium deps][gemnasium-image]][gemnasium-url] +[![node version][node-image]][node-url] +[![npm download][download-image]][download-url] + +[npm-image]: http://img.shields.io/npm/v/rc-time-picker.svg?style=flat-square +[npm-url]: http://npmjs.org/package/rc-time-picker +[travis-image]: https://img.shields.io/travis/react-component/time-picker.svg?style=flat-square +[travis-url]: https://travis-ci.org/react-component/time-picker +[coveralls-image]: https://img.shields.io/coveralls/react-component/time-picker.svg?style=flat-square +[coveralls-url]: https://coveralls.io/r/react-component/time-picker?branch=master +[gemnasium-image]: http://img.shields.io/gemnasium/react-component/time-picker.svg?style=flat-square +[gemnasium-url]: https://gemnasium.com/react-component/time-picker +[node-image]: https://img.shields.io/badge/node.js-%3E=_4.0.0-green.svg?style=flat-square +[node-url]: http://nodejs.org/download/ +[download-image]: https://img.shields.io/npm/dm/rc-time-picker.svg?style=flat-square +[download-url]: https://npmjs.org/package/rc-time-picker + +example +-------- + +http://react-component.github.io/time-picker/ + +install +------- + +``` +npm install rc-time-picker +``` + +Usage +----- + +``` +import TimePicker from 'rc-time-picker'; +import ReactDOM from 'react-dom'; +ReactDOM.render(, container); +``` + +API +--- + +### TimePicker + +| Name | Type | Default | Description | +|-------------------------|-----------------------------------|---------|-------------| +| prefixCls | String | 'rc-time-picker' | prefixCls of this component | +| clearText | String | 'clear' | clear tooltip of icon | +| disabled | Boolean | false | whether picker is disabled | +| allowEmpty | Boolean | true | allow clearing text | +| open | Boolean | false | current open state of picker. controlled prop | +| defaultValue | moment | null | default initial value | +| defaultOpenValue | moment | moment() | default open panel value, used to set utcOffset,locale if value/defaultValue absent | +| value | moment | null | current value | +| placeholder | String | '' | time input's placeholder | +| showHour | Boolean | true | whether show hour | | +| showMinute | Boolean | true | whether show minute | +| showSecond | Boolean | true | whether show second | +| format | String | - | moment format | +| disabledHours | Function | - | disabled hour options | +| disabledMinutes | Function | - | disabled minute options | +| disabledSeconds | Function | - | disabled second options | +| use12Hours | Boolean | false | 12 hours display mode | +| hideDisabledOptions | Boolean | false | whether hide disabled options | +| onChange | Function | null | called when select a different value | +| addon | Function | - | called from timepicker panel to render some addon to its bottom, like an OK button. Receives panel instance as parameter, to be able to close it like `panel.close()`.| +| placement | String | bottomLeft | one of ['left','right','top','bottom', 'topLeft', 'topRight', 'bottomLeft', 'bottomRight'] | +| transitionName | String | '' | | +| name | String | - | sets the name of the generated input | +| onOpen | Function({ open }) | | when TimePicker panel is opened | +| onClose | Function({ open }) | | when TimePicker panel is opened | + +## Test Case + +``` +npm test +npm run chrome-test +``` + +## Coverage + +``` +npm run coverage +``` + +open coverage/ dir + +License +------- + +rc-time-picker is released under the MIT license.