QA-UniApp-wlaq/components/rattenking-dtpicker/readme.md

83 lines
2.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

### DatePicker 多粒度时间选择器
可进行多粒度的时间选择器,组件名:``rattenking-dtpicker``,代码块: ruiDatePicker。
**使用方式:**
在 ``script`` 中引用组件
```javascript
import ruiDatePicker from '@/components/rattenking-dtpicker/rattenking-dtpicker.vue';
export default {
components: {ruiDatePicker}
}
```
在 ``template`` 中使用组件
```html
<ruiDatePicker
fields="second"
start="2010-00-00 00:00:00"
end="2030-12-30 23:59:59"
:value="value"
@change="bindChange"
@cancel="bindCancel"
></ruiDatePicker>
```
实际效果参考:[https://github.com/Rattenking/rui-uni-components](https://github.com/Rattenking/rui-uni-components)
**DatePicker 属性说明:**
|属性名 |类型 |默认值 |说明 |
|--- |---- |--- |--- |
|start |String |'1900-00-00 00:00:00' |限制选择器选择的最小时间 |
|end |String |'2500-12-30 23:59:59' |限制选择器选择的最大时间 |
|value |String |'' |当前时间选择器显示的时间 |
|fields |String |'second' |时间选择器的粒度 |
|disabled |Boolean|false |是否为禁用状态 |
**fields 值说明:**
|值 |类型 |说明 |
|--- |---- |--- |
|year |String |选择器粒度为年 |
|month |String |选择器粒度为月份 |
|day |String |选择器粒度为天 |
|hour |String |选择器粒度为小时 |
|minute |String |选择器粒度为分钟 |
|second |String |选择器粒度为秒 |
**事件说明:**
|事件名称 |说明 |
|---|---|
|change |时间选择器点击【确定】按钮时时触发的事件参数为picker的当前的 value|
|cancel |时间选择器点击【取消】按钮时时触发的事件|
**修复BUG说明**
v1.0.3
1. 修复获取分钟调用小时方法!
2. 修复过滤分钟使用小时判断!
v1.0.2
1. 修复限制开始和结果只有年,全部时间的开始和结束!
2. 修复默认value不传或汉字默认报错
v1.0.1
1. 修复每个月都是 31 天的 bug
2. 修复 value 值做出改变,在外部赋值才改变的 bug ,当前版本只要 value 改变,显示值就会改变!
3. 优化了默认显示值问题,如果用户不填写,直接默认当前设备的当前时间!
4. 修复二月份能够选择 31 号的 bug
**感谢:**
> 在这里特别感谢**AimerQAQ**、**icare**、**281245387@qq.com**、**椰子皮**、**2692032566@qq.com**等反馈的 bug 和给出的优化建议。有更多优化建议和需求,请联系作者。谢谢!
**致歉:**
> 由于个人的不认真导致的1.0.3版本bug,给大家带来的不便,请谅解!