github
/
element
mirror of https://github.com/ElemeFE/element
1
0
Fork 0
Code Issues Releases Wiki Activity

TimePicker doc update

pull/2/head
Leopoldthecoder 2016-08-27 21:24:16 +08:00
parent 1a2566117d
commit b527ca887e
3 changed files with 40 additions and 160 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
examples/docs/slider.md
View File

@ -137,7 +137,7 @@
``` ```
::: :::
## API ## Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 | | 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- | |---------- |-------------- |---------- |-------------------------------- |-------- |
| min | 最小值 | number | - | 0 | | min | 最小值 | number | - | 0 |

196
examples/docs/time-picker.md
View File

@ -6,23 +6,18 @@
} }
</style> </style>
## 固定时间点 ## Time Picker 时间选择器
提供几个固定的时间点供用户选择。
<div class="demo-box">
<el-time-select
v-model="value1"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30'
}"
placeholder="选择时间">
</el-time-select>
</div>
用于选择或输入日期
### 固定时间点
提供几个固定的时间点供用户选择
:::demo 使用 el-time-select 标签，分别通过`star`、`end`和`step`指定可选的起始时间、结束时间和步长
```html ```html
<el-time-select <el-time-select
v-model="value" v-model="value1"
:picker-options="{ :picker-options="{
start: '08:30', start: '08:30',
step: '00:15', step: '00:15',
@ -31,89 +26,29 @@
placeholder="选择时间"> placeholder="选择时间">
</el-time-select> </el-time-select>
``` ```
:::
## 任意时间点 ### 任意时间点
可以选择任意时间。
<div class="demo-box"> 可以选择任意时间
<el-time-picker
v-model="value2"
placeholder="任意时间点">
</el-time-picker>
</div>
:::demo 使用 el-time-picker 标签，通过`selectableRange`限制可选时间范围
```html ```html
<el-time-picker <el-time-picker
v-model="value" v-model="value2"
placeholder="任意时间点">
</el-time-picker>
```
### 通用 - 手动输入规则
<div class="demo-box">
<el-time-picker
v-model="value3"
placeholder="任意时间点">
</el-time-picker>
</div>
```html
<el-time-picker
v-model="value"
placeholder="任意时间点">
</el-time-picker>
```
### 通用 - 限制时间范围
<div class="demo-box">
<el-time-picker
v-model="value4"
:picker-options="{
selectableRange: '18:30:00 - 20:30:00'
}"
placeholder="任意时间点">
</el-time-picker>
</div>
```html
<el-time-picker
v-model="value"
:picker-options="{ :picker-options="{
selectableRange: '18:30:00 - 20:30:00' selectableRange: '18:30:00 - 20:30:00'
}" }"
placeholder="任意时间点"> placeholder="任意时间点">
</el-time-picker> </el-time-picker>
``` ```
:::
### 固定时间范围
## 固定时间范围 若先选择开始时间，则结束时间内备选项的状态会随之改变
### 先选择开始时间
先选择开始时间,结束时间内备选项的状态会随之改变。
<div class="demo-box">
<el-time-select
placeholder="起始时间"
v-model="startTime"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30'
}">
</el-time-select>
<el-time-select
placeholder="结束时间"
v-model="endTime"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30',
minTime: startTime
}">
</el-time-select>
</div>
:::demo
```html ```html
<el-time-select <el-time-select
placeholder="起始时间" placeholder="起始时间"
@ -135,72 +70,21 @@
}"> }">
</el-time-select> </el-time-select>
``` ```
:::
### 先选择结束时间 ### 任意时间范围
开始时间的备选项不随结束时间的选择改变。
<div class="demo-box"> 可选择任意的时间范围
<el-time-select
placeholder="起始时间"
v-model="startTime2"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30'
}">
</el-time-select>
<el-time-select
placeholder="结束时间"
v-model="endTime2"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30',
minTime: startTime2
}">
</el-time-select>
</div>
```html
<el-time-select
placeholder="起始时间"
v-model="startTime2"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30'
}">
</el-time-select>
<el-time-select
placeholder="结束时间"
v-model="endTime2"
:picker-options="{
start: '08:30',
step: '00:15',
end: '18:30',
minTime: startTime2
}">
</el-time-select>
```
## 任意时间范围
可选择任意的时间范围。
<div class="demo-box">
<el-time-picker
is-range
v-model="value5"
placeholder="选择时间范围">
</el-time-picker>
</div>
:::demo 添加`is-range`属性即可选择时间范围
```html ```html
<el-time-picker <el-time-picker
is-range is-range
v-model="value" v-model="value3"
placeholder="选择时间范围"> placeholder="选择时间范围">
</el-time-picker> </el-time-picker>
``` ```
:::
<script> <script>
export default { export default {
@ -209,36 +93,32 @@
value1: '', value1: '',
value2: '', value2: '',
value3: '', value3: '',
value4: '',
value5: '',
startTime: '', startTime: '',
endTime: '', endTime: ''
startTime2: '',
endTime2: ''
}; };
} }
} }
</script> </script>
## API ### Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 | | 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- | |---------- |-------------- |---------- |-------------------------------- |-------- |
| value | 绑定值，需双向绑定 | String | | | | value | 绑定值，需双向绑定 | string | - | - |
| readonly | 只读 | Boolean | | false | | readonly | 只读 | boolean | - | false |
| placeholder | 占位内容 | String | | | | placeholder | 占位内容 | string | - | - |
| format | 时间格式化 | String | 小时: `HH`, 分`mm`, 秒`ss` | 'HH:mm:ss' | | format | 时间格式化 | string | 小时：`HH`，分：`mm`，秒：`ss` | 'HH:mm:ss' |
| picker-options | 当前时间日期选择器特有的选项，参考下表 | Object | | {} | | picker-options | 当前时间日期选择器特有的选项，参考下表 | object | - | {} |
### time-select Options ### Time Select Options
| 参数 | 说明 | 类型 | 可选值 | 默认值 | | 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- | |---------- |-------------- |---------- |-------------------------------- |-------- |
| start | 开始时间 | String | |09:00 | | start | 开始时间 | string | - | 09:00 |
| end | 结束时间 | String | |18:00 | | end | 结束时间 | string | - | 18:00 |
| step | 间隔时间 | String | | 00:30 | | step | 间隔时间 | string | - | 00:30 |
| minTime | 最小时间，小于该时间的时间段将被禁用 | String | | 00:00 | | minTime | 最小时间，小于该时间的时间段将被禁用 | string | - | 00:00 |
### time-picker Options ### Time Picker Options
| 参数 | 说明 | 类型 | 可选值 | 默认值 | | 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- | |---------- |-------------- |---------- |-------------------------------- |-------- |
| selectableRange | 可选时间段，例如 `18:30:00 - 20:30:00`，或者传入数组 `['09:30:00 - 12:00:00', '14:30:00 - 18:30:00']` | String, Array | | | | selectableRange | 可选时间段，例如<br>`'18:30:00 - 20:30:00'`<br>或者传入数组<br>`['09:30:00 - 12:00:00', '14:30:00 - 18:30:00']` | string/array | - | - |

2
packages/date-picker/src/panel/time-select.vue
View File

@ -105,7 +105,7 @@
if (start && end && step) { if (start && end && step) {
let current = start; let current = start;
while (compareTime(current, end) === -1) { while (compareTime(current, end) <= 0) {
result.push({ result.push({
value: current, value: current,
disabled: compareTime(current, this.minTime || '00:00') <= 0 disabled: compareTime(current, this.minTime || '00:00') <= 0