integrated_traffic_uniapp/components/rattenking-dtpicker/readme.md

83 lines
2.7 KiB
Markdown
Raw Normal View History

2024-01-16 17:24:49 +08:00
### 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,给大家带来的不便,请谅解!