diff --git a/README.md b/README.md index 63bf7c2..c095f0e 100644 --- a/README.md +++ b/README.md @@ -111,52 +111,52 @@ You can also override some of the default locale by `lang`. ### Props -| Prop | Description | Type | Default | -| ------------------- | ------------------------------------------------ | ------------------------------------------- | -------------- | -| type | select the type of picker | date \|datetime\|year\|month\|time\|week | 'date' | -| range | if true, pick the range date | `boolean` | false | -| format | to set the date format. similar to moment.js | [token](#token) | 'YYYY-MM-DD' | -| formatter | use your own formatter, such as moment.js | [object](#formatter) | - | -| value-type | data type of the binding value | [value-type](#value-type) | 'date' | -| default-value | default date of the calendar | `Date` | new Date() | -| lang | override the default locale | `object` | | -| placeholder | input placeholder text | `string` | '' | -| editable | whether the input is editable | `boolean` | true | -| clearable | if false, don't show the clear icon | `boolean` | true | -| confirm | if true, need click the button to change value | `boolean` | false | -| confirm-text | the text of confirm button | `string` | 'OK' | -| multiple | if true, multi-select date | `boolean` | false | -| disabled | disable the component | `boolean` | false | -| disabled-date | specify the date that cannot be selected | `(date) => boolean` | - | -| disabled-time | specify the time that cannot be selected | `(date) => boolean` | - | -| append-to-body | append the popup to body | `boolean` | true | -| inline | without input | `boolean` | false | -| input-class | input classname | `string` | 'mx-input' | -| input-attr | input attrs(eg: { name: 'date', id: 'foo'}) | `object` | — | -| open | open state of picker | `boolean` | - | -| default-panel | default panel of the picker | year\|month | - | -| popup-style | popup style | `object` | — | -| popup-class | popup classes | | — | -| shortcuts | set shortcuts to select | `Array<{text, onClick}>` | - | -| title-format | format of the tooltip in calendar cell | [token](#token) | 'YYYY-MM-DD' | -| partial-update | whether update date when select year or month | `boolean` | false | -| range-separator | text of range separator | `string` | ' ~ ' | -| show-week-number | determine whether show week number | `boolean` | false | -| hour-step | interval between hours in time picker | 1 - 60 | 1 | -| minute-step | interval between minutes in time picker | 1 - 60 | 1 | -| second-step | interval between seconds in time picker | 1 - 60 | 1 | -| hour-options | custom hour column | `Array` | - | -| minute-options | custom minute column | `Array` | - | -| second-options | custom second column | `Array` | - | -| show-hour | whether show hour column | `boolean` | base on format | -| show-minute | whether show minute column | `boolean` | base on format | -| show-second | whether show second column | `boolean` | base on format | -| use12h | whether show ampm column | `boolean` | base on format | -| show-time-header | whether show header of time picker | `boolean` | false | -| time-title-format | format of the time header | [token](#token) | 'YYYY-MM-DD' | -| time-picker-options | set fixed time list to select | [time-picker-options](#time-picker-options) | null | -| prefix-class | set prefix class | `string` | 'mx' | -| scroll-duration | set the duration of scroll when hour is selected | `number` | 100 | +| Prop | Description | Type | Default | +| ------------------- | ------------------------------------------------ | ----------------------------------------------- | -------------- | +| type | select the type of picker | date \|datetime\|year\|month\|time\|week | 'date' | +| range | if true, pick the range date | `boolean` | false | +| format | to set the date format. similar to moment.js | [token](#token) | 'YYYY-MM-DD' | +| formatter | use your own formatter, such as moment.js | [object](#formatter) | - | +| value-type | data type of the binding value | [value-type](#value-type) | 'date' | +| default-value | default date of the calendar | `Date` | new Date() | +| lang | override the default locale | `object` | | +| placeholder | input placeholder text | `string` | '' | +| editable | whether the input is editable | `boolean` | true | +| clearable | if false, don't show the clear icon | `boolean` | true | +| confirm | if true, need click the button to change value | `boolean` | false | +| confirm-text | the text of confirm button | `string` | 'OK' | +| multiple | if true, multi-select date | `boolean` | false | +| disabled | disable the component | `boolean` | false | +| disabled-date | specify the date that cannot be selected | `(date: Date, currentValue: Date[]) => boolean` | - | +| disabled-time | specify the time that cannot be selected | `(date: Date) => boolean` | - | +| append-to-body | append the popup to body | `boolean` | true | +| inline | without input | `boolean` | false | +| input-class | input classname | `string` | 'mx-input' | +| input-attr | input attrs(eg: { name: 'date', id: 'foo'}) | `object` | — | +| open | open state of picker | `boolean` | - | +| default-panel | default panel of the picker | year\|month | - | +| popup-style | popup style | `object` | — | +| popup-class | popup classes | | — | +| shortcuts | set shortcuts to select | `Array<{text, onClick}>` | - | +| title-format | format of the tooltip in calendar cell | [token](#token) | 'YYYY-MM-DD' | +| partial-update | whether update date when select year or month | `boolean` | false | +| range-separator | text of range separator | `string` | ' ~ ' | +| show-week-number | determine whether show week number | `boolean` | false | +| hour-step | interval between hours in time picker | 1 - 60 | 1 | +| minute-step | interval between minutes in time picker | 1 - 60 | 1 | +| second-step | interval between seconds in time picker | 1 - 60 | 1 | +| hour-options | custom hour column | `Array` | - | +| minute-options | custom minute column | `Array` | - | +| second-options | custom second column | `Array` | - | +| show-hour | whether show hour column | `boolean` | base on format | +| show-minute | whether show minute column | `boolean` | base on format | +| show-second | whether show second column | `boolean` | base on format | +| use12h | whether show ampm column | `boolean` | base on format | +| show-time-header | whether show header of time picker | `boolean` | false | +| time-title-format | format of the time header | [token](#token) | 'YYYY-MM-DD' | +| time-picker-options | set fixed time list to select | [time-picker-options](#time-picker-options) | null | +| prefix-class | set prefix class | `string` | 'mx' | +| scroll-duration | set the duration of scroll when hour is selected | `number` | 100 | #### Token diff --git a/README.zh-CN.md b/README.zh-CN.md index 1dac21e..28b9521 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -109,52 +109,52 @@ import 'vue2-datepicker/locale/zh-cn'; ### Props -| 属性 | 描述 | 类型 | 默认值 | -| ------------------- | ------------------------------------------------ | ------------------------------------------- | -------------- | -| type | 日期选择的类型 | date \|datetime\|year\|month\|time\|week | 'date' | -| range | 如果是 true, 变成日期范围选择 | `boolean` | false | -| format | 设置格式化的 token, 类似 moment.js | [token](#token) | 'YYYY-MM-DD' | -| formatter | 使用自己的格式化程序, 比如 moment.js | [object](#formatter) | - | -| value-type | 设置绑定值的类型 | [value-type](#value-type) | 'date' | -| default-value | 设置日历默认的时间 | `Date` | new Date() | -| lang | 覆盖默认的语音设置 | `object` | | -| placeholder | 输入框的 placeholder | `string` | '' | -| editable | 输入框是否可以输入 | `boolean` | true | -| clearable | 是否显示清除按钮 | `boolean` | true | -| confirm | 是否需要确认 | `boolean` | false | -| confirm-text | 确认按钮的文字 | `string` | 'OK' | -| multiple | 如果是 true, 可以选择多个日期 | `boolean` | false | -| disabled | 禁用组件 | `boolean` | false | -| disabled-date | 禁止选择的日期 | `(date) => boolean` | - | -| disabled-time | 禁止选择的时间 | `(date) => boolean` | - | -| append-to-body | 弹出层插入到 body 元素下 | `boolean` | true | -| inline | 不显示输入框 | `boolean` | false | -| input-class | 输入框的类 | `string` | 'mx-input' | -| input-attr | 输入框的其他属性(eg: { name: 'date', id: 'foo'}) | `object` | — | -| open | 控制弹出层的显示 | `boolean` | - | -| default-panel | 控制打开的面板 | year\|month | - | -| popup-style | 弹出层的样式 | `object` | — | -| popup-class | 弹出层的类 | | — | -| shortcuts | 设置快捷选择 | `Array<{text, onClick}>` | - | -| title-format | 日历单元格的 tooltip | [token](#token) | 'YYYY-MM-DD' | -| partial-update | 是否更新日期当选择年或月的时候 | `boolean` | false | -| range-separator | 范围分隔符 | `string` | ' ~ ' | -| show-week-number | 是否显示星期数字 | `boolean` | false | -| hour-step | 小时列的间隔 | 1 - 60 | 1 | -| minute-step | 分钟列的间隔 | 1 - 60 | 1 | -| second-step | 秒列的间隔 | 1 - 60 | 1 | -| hour-options | 自定义小时列 | `Array` | - | -| minute-options | 自定义分钟列 | `Array` | - | -| second-options | 自定义秒列 | `Array` | - | -| show-hour | 是否显示小时列 | `boolean` | base on format | -| show-minute | 是否显示分钟列 | `boolean` | base on format | -| show-second | 是否显示秒列 | `boolean` | base on format | -| use12h | 是否显示 ampm 列 | `boolean` | base on format | -| show-time-header | 是否显示时间选择面板的头部 | `boolean` | false | -| time-title-format | 时间面板头部的格式化 | [token](#token) | 'YYYY-MM-DD' | -| time-picker-options | 设置固定时间去选择 | [time-picker-options](#time-picker-options) | null | -| prefix-class | 设置 class 的前缀 | `string` | 'mx' | -| scroll-duration | 设置滚动时候当选中小时的时候 | `number` | 100 | +| 属性 | 描述 | 类型 | 默认值 | +| ------------------- | ------------------------------------------------ | ----------------------------------------------- | -------------- | +| type | 日期选择的类型 | date \|datetime\|year\|month\|time\|week | 'date' | +| range | 如果是 true, 变成日期范围选择 | `boolean` | false | +| format | 设置格式化的 token, 类似 moment.js | [token](#token) | 'YYYY-MM-DD' | +| formatter | 使用自己的格式化程序, 比如 moment.js | [object](#formatter) | - | +| value-type | 设置绑定值的类型 | [value-type](#value-type) | 'date' | +| default-value | 设置日历默认的时间 | `Date` | new Date() | +| lang | 覆盖默认的语音设置 | `object` | | +| placeholder | 输入框的 placeholder | `string` | '' | +| editable | 输入框是否可以输入 | `boolean` | true | +| clearable | 是否显示清除按钮 | `boolean` | true | +| confirm | 是否需要确认 | `boolean` | false | +| confirm-text | 确认按钮的文字 | `string` | 'OK' | +| multiple | 如果是 true, 可以选择多个日期 | `boolean` | false | +| disabled | 禁用组件 | `boolean` | false | +| disabled-date | 禁止选择的日期 | `(date: Date, currentValue: Date[]) => boolean` | - | +| disabled-time | 禁止选择的时间 | `(date: Date) => boolean` | - | +| append-to-body | 弹出层插入到 body 元素下 | `boolean` | true | +| inline | 不显示输入框 | `boolean` | false | +| input-class | 输入框的类 | `string` | 'mx-input' | +| input-attr | 输入框的其他属性(eg: { name: 'date', id: 'foo'}) | `object` | — | +| open | 控制弹出层的显示 | `boolean` | - | +| default-panel | 控制打开的面板 | year\|month | - | +| popup-style | 弹出层的样式 | `object` | — | +| popup-class | 弹出层的类 | | — | +| shortcuts | 设置快捷选择 | `Array<{text, onClick}>` | - | +| title-format | 日历单元格的 tooltip | [token](#token) | 'YYYY-MM-DD' | +| partial-update | 是否更新日期当选择年或月的时候 | `boolean` | false | +| range-separator | 范围分隔符 | `string` | ' ~ ' | +| show-week-number | 是否显示星期数字 | `boolean` | false | +| hour-step | 小时列的间隔 | 1 - 60 | 1 | +| minute-step | 分钟列的间隔 | 1 - 60 | 1 | +| second-step | 秒列的间隔 | 1 - 60 | 1 | +| hour-options | 自定义小时列 | `Array` | - | +| minute-options | 自定义分钟列 | `Array` | - | +| second-options | 自定义秒列 | `Array` | - | +| show-hour | 是否显示小时列 | `boolean` | base on format | +| show-minute | 是否显示分钟列 | `boolean` | base on format | +| show-second | 是否显示秒列 | `boolean` | base on format | +| use12h | 是否显示 ampm 列 | `boolean` | base on format | +| show-time-header | 是否显示时间选择面板的头部 | `boolean` | false | +| time-title-format | 时间面板头部的格式化 | [token](#token) | 'YYYY-MM-DD' | +| time-picker-options | 设置固定时间去选择 | [time-picker-options](#time-picker-options) | null | +| prefix-class | 设置 class 的前缀 | `string` | 'mx' | +| scroll-duration | 设置滚动时候当选中小时的时候 | `number` | 100 | #### Token