]> git.immae.eu Git - github/fretlink/time-picker.git/blobdiff - README.md
Added am/pm switching test
[github/fretlink/time-picker.git] / README.md
index c6e8e1c98d401887e1e426c79654e16c09789745..d8a35b9c3a004440b4dbbe3c9192e51efad6e67b 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,8 +1,32 @@
-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
 -------
 
@@ -15,7 +39,6 @@ Usage
 
 ```
 import TimePicker from 'rc-time-picker';
-import React from 'react';
 import ReactDOM from 'react-dom';
 ReactDOM.render(<TimePicker />, container);
 ```
@@ -25,21 +48,48 @@ API
 
 ### TimePicker
 
-| Name          | Type                       | Default                                       | Description                                   |
-|---------------|----------------------------|-----------------------------------------------|-----------------------------------------------|
-| prefixCls     | String                     |                                               | prefixCls of this component                   |
-| locale        | Object                     | import from 'rc-time-picker/lib/locale/en_US' |                                               |
-| disabled      | Boolean                    | false                                         | whether picker is disabled                    |
-| open          | Boolean                    | false                                         | current open state of picker. controlled prop |
-| value         | GregorianCalendar          | null                                          | current value like input's value              |
-| placeholder   | String                     | ''                                            | time input's placeholder                      |
-| formatter     | GregorianCalendarFormatter | HH:mm:ss or HH:mm or mm:ss                    |                                               |
-| hourOptions   | Array<String>              | hour options                                  |                                               |
-| minuteOptions | Array<String>              | minute options                                |                                               |
-| secondOptions | Array<String>              | second options                                |                                               |
-| onChange      | Function                   | null                                          | called when select a different value          |
-| onOpen        | Function                   | null                                          | called when open picker                       |
-| onClose       | Function                   | null                                          | called when close picker                      |
+| Name                    | Type                              | Default                                       | Description                                                                                |
+|-------------------------|-----------------------------------|-----------------------------------------------|--------------------------------------------------------------------------------------------|
+| prefixCls               | String                            |                                               | prefixCls of this component                                                                |
+| clearText               | String                            | 'clear'                                       |                                                                                            |
+| disabled                | Boolean                           | false                                         | whether picker is disabled                                                                 |
+| clearText               | String                            | clear                                         | clear 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                           | whether show hour                             |                                                                                            |
+| showMinute              | Boolean                           | whether show minute                             |                                                                                            |
+| showSecond              | Boolean                           | whether show second                           |                                                                                            |
+| format                  | String                            |                                               |                                                                                            |
+| disabledHours           | Function                          | disabled hour options                         |                                                                                            |
+| disabledMinutes         | Function                          | disabled minute options                       |                                                                                            |
+| disabledSeconds         | Function                          | disabled second options                       |                                                                                            |
+| use12Hours              | Boolean                           | 12 hours display mode                         |                                                                                            |
+| hideDisabledOptions     | Boolean                           | whether hide disabled options                 |                                                                                            |
+| onChange                | Function                          | null                                          | called when select a different value                                                       |
+| addon                   | Function                          | nothing                                       | 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
 -------