datepicker

react datepicker component for tinper-bee

可定制的日期组件

使用

使用单独的datepicker包

组件引入

先进行下载bee-datepicker包

npm install --save bee-datepicker

组件调用

import DatePicker from 'bee-datepicker';
ReactDOM.render(
        <DatePicker></DatePicker>
        , document.getElementById('target'));

样式引入

• 可以使用link引入build目录下DatePicker.css

<link rel="stylesheet" href="./node_modules/bee-datepicker/build/DatePicker.css">

• 可以在js中import样式

import "./node_modules/bee-datepicker/src/DatePicker.scss"
//或是
import "./node_modules/bee-datepicker/build/DatePicker.css"

API

DatePicker

|参数|说明|类型|默认值| |:---|:-----|:----|:------| |prefixCls|组件的前缀|String| - | |className|添加节点的样式|String| - | |dropdownClassName|添加下拉面板的样式|String| - | |style|添加内联样式| Object| - | |dateRender|日期表格|(current, value) => React.Node| - | |renderSidebar|侧边栏|() => React.Node| - | |renderFooter|扩展底边栏|() => React.Node| - | | defaultValue|默认值，输入框的默认值| moment| - | | value|日期| moment| - | | locale|日历的语言 | Object |en_US | | format|日期格式化| String | - | | open|日期组件隐藏、显示| Boolean | false | | disabled|是否禁用功能|Boolean| false | | disabledDate |禁用的日期|Function(current:moment):Boolean| - | | disabledTime |禁用的时间|Function(current:moment):Object| - | | showDateInput|显示日期输入框|Boolean| true | | showWeekNumber|是否显示周数| Boolean| false| | showToday|是否显示今天| Boolean| true| | showOk|底边栏是否显示ok按钮| Boolean | auto | | onSelect|选择日期的回调函数|Function(date: moment)| - | | onChange|日期改变的回调函数|Function(date: moment)| - | | onOk|点击确定按钮的回调|Function(date: moment)| - | | dateInputPlaceholder|日期的placeholder| String | - | | showTime | 是否显示时间选择面板 | Boolean | - | | renderIcon |更改默认的图标|Function| () => | | closeIcon |鼠标划过清空内容的icon|Function| () => | | getCalendarContainer |更改默认渲染位置|Function| - | | keyboardInput |外层输入框是否支持键盘输入|Boolean|false| | iconClick |日期按钮点击的回调|Function|-| | outInputFocus |外层输入框获得焦点的回调|Function|-| | outInputKeydown |外层输入框keydown回调|Function|-|

注：使用keyboardInput时，以下api变化

• 输入内容的格式需要个format格式相同，也可以有部分变化，变化范围参考 moment.js。例如：format='YYYY-MM-DD' 输入 '19-1-1'也可识别
• 当输入日期格式无法转换为 moment 对象时，onChange,onClick回调内对应的moment参数值为 null

MonthPicker

|参数|说明|类型|默认值| |:---|:-----|:----|:------| |prefixCls|组件的前缀|String|-| |className|添加节点的样式|String| - | |style|添加内联样式| Object| - | | value |当前值，如输入框的值|moment| - | | defaultValue|默认值，输入框的默认值| moment| - | | locale|语言 | Object |en_US | | disabledDate |禁用的日期|Function(current:moment):Boolean| - | | onSelect|选择日期的回调函数|Function(date: moment)| - | | onChange|日期改变的回调函数|Function(date: moment)| - | | monthCellRender |月份的渲染方法| function | - | | dateCellRender|日期的渲染方法|function| - | | monthCellContentRender|自定义月份的渲染方法，将被添加渲染内容中| function| - | | getCalendarContainer |更改默认渲染位置|Function| - | | closeIcon |鼠标划过清空内容的icon|Function| () => |

RangePicker

|参数|说明|类型|默认值| |:---|:-----|:----|:------| |prefixCls|组件的前缀|String| - | |className|添加节点的样式|String| - | |style|添加内联样式| Object| - | |dateRender|日期表格|(current, value) => React.Node| - | |renderSidebar|侧边栏|() => React.Node| - | |renderFooter|扩展底边栏|() => React.Node| - | | value|当前选中的区间|moment[]| - | | defaultValue|默认选中的区间| moment[]| - | | locale|日历的语言 | Object |en_US | | format|日期格式化| String | - | | disabledDate |禁用的日期|Function(current:moment):Boolean| - | | disabledTime |禁用的时间|Function(current:moment):Object| - | | showDateInput|显示日期输入康|Boolean| true | | showWeekNumber|是否显示周数| Boolean| false| | showToday|是否显示今天| Boolean| true| | showOk|底边栏是否显示ok按钮| Boolean | auto | | showClear|是否显示清除按钮| Boolean|false| | onSelect|选择日期的回调函数|Function(date: moment)| - | | onChange|日期改变的回调函数|Function(date: moment)| - | | dateInputPlaceholder|日期的placeholder| String | - | | type|是否固定开始或结束选定的值|enum('both','start', 'end')| - | | getCalendarContainer |更改默认渲染位置|Function| - | | closeIcon |鼠标划过清空内容的icon|Function| () => |

WeekPicker

|参数|说明|类型|默认值| |:---|:-----|:----|:------| | placeholder|输入框placeholder|String| - | | defaultValue|默认值|moment| - | | getCalendarContainer |更改默认渲染位置|Function| - | | closeIcon |鼠标划过清空内容的icon|Function| () => |

YearPicker

|参数|说明|类型|默认值| |:---|:-----|:----|:------| | placeholder |输入框placeholder|String| - | | defaultValue|默认值|moment| 当前年 | | getCalendarContainer |更改默认渲染位置|Function| - | | format|日期格式化| String | - | | disabled|是否禁用功能|Boolean| false | | closeIcon |鼠标划过清空内容的icon|Function| () => |

DatePicker 已支持的键盘操作

|按键|功能| |:---|:----| |↓(下箭) |打开面板| |esc |关闭面板| |delete |清除内容|

setup develop environment

$ npm install -g bee-tools
$ git clone https://github.com/tinper-bee/bee-datepicker.git
$ cd bee-datepicker
$ npm install
$ npm run dev