Package Exports
- @rc-component/picker
- @rc-component/picker/assets/index.css
- @rc-component/picker/assets/index.less
- @rc-component/picker/es/generate
- @rc-component/picker/es/generate/dateFns
- @rc-component/picker/es/generate/dayjs
- @rc-component/picker/es/generate/index
- @rc-component/picker/es/generate/luxon
- @rc-component/picker/es/generate/moment
- @rc-component/picker/es/interface
- @rc-component/picker/es/locale/am_ET
- @rc-component/picker/es/locale/ar_EG
- @rc-component/picker/es/locale/az_AZ
- @rc-component/picker/es/locale/bg_BG
- @rc-component/picker/es/locale/bn_BD
- @rc-component/picker/es/locale/by_BY
- @rc-component/picker/es/locale/ca_ES
- @rc-component/picker/es/locale/common
- @rc-component/picker/es/locale/cs_CZ
- @rc-component/picker/es/locale/da_DK
- @rc-component/picker/es/locale/de_DE
- @rc-component/picker/es/locale/el_GR
- @rc-component/picker/es/locale/en_GB
- @rc-component/picker/es/locale/en_US
- @rc-component/picker/es/locale/es_ES
- @rc-component/picker/es/locale/es_MX
- @rc-component/picker/es/locale/et_EE
- @rc-component/picker/es/locale/eu_ES
- @rc-component/picker/es/locale/fa_IR
- @rc-component/picker/es/locale/fi_FI
- @rc-component/picker/es/locale/fr_BE
- @rc-component/picker/es/locale/fr_CA
- @rc-component/picker/es/locale/fr_FR
- @rc-component/picker/es/locale/ga_IE
- @rc-component/picker/es/locale/gl_ES
- @rc-component/picker/es/locale/he_IL
- @rc-component/picker/es/locale/hi_IN
- @rc-component/picker/es/locale/hr_HR
- @rc-component/picker/es/locale/hu_HU
- @rc-component/picker/es/locale/id_ID
- @rc-component/picker/es/locale/is_IS
- @rc-component/picker/es/locale/it_IT
- @rc-component/picker/es/locale/ja_JP
- @rc-component/picker/es/locale/ka_GE
- @rc-component/picker/es/locale/kk_KZ
- @rc-component/picker/es/locale/km_KH
- @rc-component/picker/es/locale/kmr_IQ
- @rc-component/picker/es/locale/kn_IN
- @rc-component/picker/es/locale/ko_KR
- @rc-component/picker/es/locale/lt_LT
- @rc-component/picker/es/locale/lv_LV
- @rc-component/picker/es/locale/mk_MK
- @rc-component/picker/es/locale/ml_IN
- @rc-component/picker/es/locale/mn_MN
- @rc-component/picker/es/locale/mr_IN
- @rc-component/picker/es/locale/ms_MY
- @rc-component/picker/es/locale/my_MM
- @rc-component/picker/es/locale/nb_NO
- @rc-component/picker/es/locale/ne_NP
- @rc-component/picker/es/locale/nl_BE
- @rc-component/picker/es/locale/nl_NL
- @rc-component/picker/es/locale/pl_PL
- @rc-component/picker/es/locale/pt_BR
- @rc-component/picker/es/locale/pt_PT
- @rc-component/picker/es/locale/ro_RO
- @rc-component/picker/es/locale/ru_RU
- @rc-component/picker/es/locale/si_LK
- @rc-component/picker/es/locale/sk_SK
- @rc-component/picker/es/locale/sl_SI
- @rc-component/picker/es/locale/sr_Cyrl_RS
- @rc-component/picker/es/locale/sr_RS
- @rc-component/picker/es/locale/sv_SE
- @rc-component/picker/es/locale/ta_IN
- @rc-component/picker/es/locale/te_IN
- @rc-component/picker/es/locale/th_TH
- @rc-component/picker/es/locale/tk_TK
- @rc-component/picker/es/locale/tr_TR
- @rc-component/picker/es/locale/ug_CN
- @rc-component/picker/es/locale/uk_UA
- @rc-component/picker/es/locale/ur_PK
- @rc-component/picker/es/locale/uz_UZ
- @rc-component/picker/es/locale/vi_VN
- @rc-component/picker/es/locale/zh_CN
- @rc-component/picker/es/locale/zh_TW
- @rc-component/picker/generate
- @rc-component/picker/generate/dateFns
- @rc-component/picker/generate/dayjs
- @rc-component/picker/generate/index
- @rc-component/picker/generate/luxon
- @rc-component/picker/generate/moment
- @rc-component/picker/interface
- @rc-component/picker/lib/generate
- @rc-component/picker/lib/generate/dateFns
- @rc-component/picker/lib/generate/dayjs
- @rc-component/picker/lib/generate/index
- @rc-component/picker/lib/generate/luxon
- @rc-component/picker/lib/generate/moment
- @rc-component/picker/lib/interface
- @rc-component/picker/lib/locale/am_ET
- @rc-component/picker/lib/locale/ar_EG
- @rc-component/picker/lib/locale/az_AZ
- @rc-component/picker/lib/locale/bg_BG
- @rc-component/picker/lib/locale/bn_BD
- @rc-component/picker/lib/locale/by_BY
- @rc-component/picker/lib/locale/ca_ES
- @rc-component/picker/lib/locale/common
- @rc-component/picker/lib/locale/cs_CZ
- @rc-component/picker/lib/locale/da_DK
- @rc-component/picker/lib/locale/de_DE
- @rc-component/picker/lib/locale/el_GR
- @rc-component/picker/lib/locale/en_GB
- @rc-component/picker/lib/locale/en_US
- @rc-component/picker/lib/locale/es_ES
- @rc-component/picker/lib/locale/es_MX
- @rc-component/picker/lib/locale/et_EE
- @rc-component/picker/lib/locale/eu_ES
- @rc-component/picker/lib/locale/fa_IR
- @rc-component/picker/lib/locale/fi_FI
- @rc-component/picker/lib/locale/fr_BE
- @rc-component/picker/lib/locale/fr_CA
- @rc-component/picker/lib/locale/fr_FR
- @rc-component/picker/lib/locale/ga_IE
- @rc-component/picker/lib/locale/gl_ES
- @rc-component/picker/lib/locale/he_IL
- @rc-component/picker/lib/locale/hi_IN
- @rc-component/picker/lib/locale/hr_HR
- @rc-component/picker/lib/locale/hu_HU
- @rc-component/picker/lib/locale/id_ID
- @rc-component/picker/lib/locale/is_IS
- @rc-component/picker/lib/locale/it_IT
- @rc-component/picker/lib/locale/ja_JP
- @rc-component/picker/lib/locale/ka_GE
- @rc-component/picker/lib/locale/kk_KZ
- @rc-component/picker/lib/locale/km_KH
- @rc-component/picker/lib/locale/kmr_IQ
- @rc-component/picker/lib/locale/kn_IN
- @rc-component/picker/lib/locale/ko_KR
- @rc-component/picker/lib/locale/lt_LT
- @rc-component/picker/lib/locale/lv_LV
- @rc-component/picker/lib/locale/mk_MK
- @rc-component/picker/lib/locale/ml_IN
- @rc-component/picker/lib/locale/mn_MN
- @rc-component/picker/lib/locale/mr_IN
- @rc-component/picker/lib/locale/ms_MY
- @rc-component/picker/lib/locale/my_MM
- @rc-component/picker/lib/locale/nb_NO
- @rc-component/picker/lib/locale/ne_NP
- @rc-component/picker/lib/locale/nl_BE
- @rc-component/picker/lib/locale/nl_NL
- @rc-component/picker/lib/locale/pl_PL
- @rc-component/picker/lib/locale/pt_BR
- @rc-component/picker/lib/locale/pt_PT
- @rc-component/picker/lib/locale/ro_RO
- @rc-component/picker/lib/locale/ru_RU
- @rc-component/picker/lib/locale/si_LK
- @rc-component/picker/lib/locale/sk_SK
- @rc-component/picker/lib/locale/sl_SI
- @rc-component/picker/lib/locale/sr_Cyrl_RS
- @rc-component/picker/lib/locale/sr_RS
- @rc-component/picker/lib/locale/sv_SE
- @rc-component/picker/lib/locale/ta_IN
- @rc-component/picker/lib/locale/te_IN
- @rc-component/picker/lib/locale/th_TH
- @rc-component/picker/lib/locale/tk_TK
- @rc-component/picker/lib/locale/tr_TR
- @rc-component/picker/lib/locale/ug_CN
- @rc-component/picker/lib/locale/uk_UA
- @rc-component/picker/lib/locale/ur_PK
- @rc-component/picker/lib/locale/uz_UZ
- @rc-component/picker/lib/locale/vi_VN
- @rc-component/picker/lib/locale/zh_CN
- @rc-component/picker/lib/locale/zh_TW
- @rc-component/picker/locale/am_ET
- @rc-component/picker/locale/ar_EG
- @rc-component/picker/locale/az_AZ
- @rc-component/picker/locale/bg_BG
- @rc-component/picker/locale/bn_BD
- @rc-component/picker/locale/by_BY
- @rc-component/picker/locale/ca_ES
- @rc-component/picker/locale/common
- @rc-component/picker/locale/cs_CZ
- @rc-component/picker/locale/da_DK
- @rc-component/picker/locale/de_DE
- @rc-component/picker/locale/el_GR
- @rc-component/picker/locale/en_GB
- @rc-component/picker/locale/en_US
- @rc-component/picker/locale/es_ES
- @rc-component/picker/locale/es_MX
- @rc-component/picker/locale/et_EE
- @rc-component/picker/locale/eu_ES
- @rc-component/picker/locale/fa_IR
- @rc-component/picker/locale/fi_FI
- @rc-component/picker/locale/fr_BE
- @rc-component/picker/locale/fr_CA
- @rc-component/picker/locale/fr_FR
- @rc-component/picker/locale/ga_IE
- @rc-component/picker/locale/gl_ES
- @rc-component/picker/locale/he_IL
- @rc-component/picker/locale/hi_IN
- @rc-component/picker/locale/hr_HR
- @rc-component/picker/locale/hu_HU
- @rc-component/picker/locale/id_ID
- @rc-component/picker/locale/is_IS
- @rc-component/picker/locale/it_IT
- @rc-component/picker/locale/ja_JP
- @rc-component/picker/locale/ka_GE
- @rc-component/picker/locale/kk_KZ
- @rc-component/picker/locale/km_KH
- @rc-component/picker/locale/kmr_IQ
- @rc-component/picker/locale/kn_IN
- @rc-component/picker/locale/ko_KR
- @rc-component/picker/locale/lt_LT
- @rc-component/picker/locale/lv_LV
- @rc-component/picker/locale/mk_MK
- @rc-component/picker/locale/ml_IN
- @rc-component/picker/locale/mn_MN
- @rc-component/picker/locale/mr_IN
- @rc-component/picker/locale/ms_MY
- @rc-component/picker/locale/my_MM
- @rc-component/picker/locale/nb_NO
- @rc-component/picker/locale/ne_NP
- @rc-component/picker/locale/nl_BE
- @rc-component/picker/locale/nl_NL
- @rc-component/picker/locale/pl_PL
- @rc-component/picker/locale/pt_BR
- @rc-component/picker/locale/pt_PT
- @rc-component/picker/locale/ro_RO
- @rc-component/picker/locale/ru_RU
- @rc-component/picker/locale/si_LK
- @rc-component/picker/locale/sk_SK
- @rc-component/picker/locale/sl_SI
- @rc-component/picker/locale/sr_Cyrl_RS
- @rc-component/picker/locale/sr_RS
- @rc-component/picker/locale/sv_SE
- @rc-component/picker/locale/ta_IN
- @rc-component/picker/locale/te_IN
- @rc-component/picker/locale/th_TH
- @rc-component/picker/locale/tk_TK
- @rc-component/picker/locale/tr_TR
- @rc-component/picker/locale/ug_CN
- @rc-component/picker/locale/uk_UA
- @rc-component/picker/locale/ur_PK
- @rc-component/picker/locale/uz_UZ
- @rc-component/picker/locale/vi_VN
- @rc-component/picker/locale/zh_CN
- @rc-component/picker/locale/zh_TW
Readme
rc-picker
Live Demo
https://react-component.github.io/picker/
Install
Usage
import Picker from 'rc-picker';
import 'rc-picker/assets/index.css';
import { render } from 'react-dom';
render(<Picker />, mountNode);API
Picker
| Property | Type | Default | Description |
|---|---|---|---|
| prefixCls | String | rc-picker | prefixCls of this component |
| className | String | '' | additional css class of root dom node |
| style | React.CSSProperties | additional style of root dom node | |
| dropdownClassName | String | '' | additional className applied to dropdown |
| popupAlign | Object:alignConfig of dom-align | value will be merged into placement's popupAlign config | |
| popupStyle | React.CSSProperties | customize popup style | |
| transitionName | String | '' | css class for animation |
| locale | Object | import from 'rc-picker/lib/locale/en_US' | rc-picker locale |
| inputReadOnly | boolean | false | set input to read only |
| allowClear | boolean | { clearIcon?: ReactNode } | false | whether show clear button or customize clear button |
| autoFocus | boolean | false | whether auto focus |
| showTime | boolean | Object | showTime options | to provide an additional time selection |
| picker | time | date | week | month | year | control which kind of panel should be shown | |
| previewValue | false | hover | hover | When the user selects the date hover option, the value of the input field undergoes a temporary change |
| format | String | String[] | depends on whether you set timePicker and your locale | use to format/parse date(without time) value to/from input. When an array is provided, all values are used for parsing and first value for display |
| use12Hours | boolean | false | 12 hours display mode |
| value | moment | current value like input's value | |
| defaultValue | moment | defaultValue like input's defaultValue | |
| open | boolean | false | current open state of picker. controlled prop |
| suffixIcon | ReactNode | The custom suffix icon | |
| prevIcon | ReactNode | The custom prev icon | |
| nextIcon | ReactNode | The custom next icon | |
| superPrevIcon | ReactNode | The custom super prev icon | |
| superNextIcon | ReactNode | The custom super next icon | |
| disabled | boolean | false | whether the picker is disabled |
| placeholder | String | picker input's placeholder | |
| getPopupContainer | function(trigger) | to set the container of the floating layer, while the default is to create a div element in body | |
| onChange | Function(date: moment, dateString: string) | a callback function, can be executed when the selected time is changing | |
| onOpenChange | Function(open:boolean) | called when open/close picker | |
| onFocus | (event:React.FocusEvent<HTMLInputElement>) => void | called like input's on focus | |
| onBlur | (event:React.FocusEvent<HTMLInputElement>) => void | called like input's on blur | |
| onKeyDown | (event:React.KeyboardEvent<HTMLInputElement>, preventDefault: () => void) => void | input on keydown event | |
| direction | String: ltr or rtl | Layout direction of picker component, it supports RTL direction too. |
PickerPanel
| Property | Type | Default | Description |
|---|---|---|---|
| prefixCls | String | rc-picker | prefixCls of this component |
| className | String | '' | additional css class of root dom |
| style | React.CSSProperties | additional style of root dom node | |
| locale | Object | import from 'rc-picker/lib/locale/en_US' | rc-picker locale |
| value | moment | current value like input's value | |
| defaultValue | moment | defaultValue like input's defaultValue | |
| defaultPickerValue | moment | Set default display picker view date | |
| mode | time | datetime | date | week | month | year | decade | control which kind of panel | |
| picker | time | date | week | month | year | control which kind of panel | |
| tabIndex | Number | 0 | view tabIndex |
| showTime | boolean | Object | showTime options | to provide an additional time selection |
| showToday | boolean | false | whether to show today button |
| disabledDate | Function(date:moment) => boolean | whether to disable select of current date | |
| dateRender | Function(currentDate:moment, today:moment) => React.Node | custom rendering function for date cells | |
| monthCellRender | Function(currentDate:moment, locale:Locale) => React.Node | Custom month cell render method | |
| renderExtraFooter | (mode) => React.Node | extra footer | |
| onSelect | Function(date: moment) | a callback function, can be executed when the selected time | |
| onPanelChange | Function(value: moment, mode) | callback when picker panel mode is changed | |
| onMouseDown | (event:React.MouseEvent<HTMLInputElement>) => void | callback when executed onMouseDown event | |
| direction | String: ltr or rtl | Layout direction of picker component, it supports RTL direction too. |
RangePicker
| Property | Type | Default | Description |
| --- | --- | --- | --- | --- |
| prefixCls | String | rc-picker | prefixCls of this component |
| className | String | '' | additional css class of root dom |
| style | React.CSSProperties | | additional style of root dom node |
| locale | Object | import from 'rc-picker/lib/locale/en_US' | rc-picker locale |
| value | moment | | current value like input's value |
| defaultValue | moment | | defaultValue like input's defaultValue |
| defaultPickerValue | moment | | Set default display picker view date |
| separator | String | '~' | set separator between inputs |
| picker | time | date | week | month | year | | control which kind of panel |
| previewValue | false | hover | hover | When the user selects the date hover option, the value of the input field undergoes a temporary change |
| placeholder | [String, String] | | placeholder of date input |
| showTime | boolean | Object | showTime options | to provide an additional time selection |
| showTime.defaultValue | [moment, moment] | | to set default time of selected date |
| use12Hours | boolean | false | 12 hours display mode |
| disabledTime | Function(date: moment, type:'start'|'end'):Object | | | to specify the time that cannot be selected |
| ranges | { String | [range: string]: moment[] } | { [range: string]: () => moment[] } | | preseted ranges for quick selection |
| format | String | String[] | depends on whether you set timePicker and your locale | use to format/parse date(without time) value to/from input. When an array is provided, all values are used for parsing and first value for display |
| allowEmpty | [boolean, boolean] | | allow range picker clearing text |
| selectable | [boolean, boolean] | | whether to selected picker |
| disabled | boolean | false | whether the range picker is disabled |
| onChange | Function(value:[moment], formatString: [string, string]) | | a callback function, can be executed when the selected time is changing |
| onCalendarChange | Function(value:[moment], formatString: [string, string], info: { range:'start'|'end' }) | | a callback function, can be executed when the start time or the end time of the range is changing |
| direction | String: ltr or rtl | | Layout direction of picker component, it supports RTL direction too. |
| order | boolean | true | (TimeRangePicker only) false to disable auto order |
showTime-options
| Property | Type | Default | Description |
|---|---|---|---|
| format | String | moment format | |
| showHour | boolean | true | whether show hour |
| showMinute | boolean | true | whether show minute |
| showSecond | boolean | true | whether show second |
| use12Hours | boolean | false | 12 hours display mode |
| hourStep | Number | 1 | interval between hours in picker |
| minuteStep | Number | 1 | interval between minutes in picker |
| secondStep | Number | 1 | interval between seconds in picker |
| hideDisabledOptions | boolean | false | whether hide disabled options |
| defaultValue | moment | null | default initial value |
Development
npm install
npm startLicense
rc-picker is released under the MIT license.
