Skip to content

E
Element
Commit b527ca88 authored by Leopoldthecoder's avatar Leopoldthecoder
Browse files
Options

TimePicker doc update

parent 1a256611
Hide whitespace changes
Inline Side-by-side
Showing with 40 additions and 160 deletions
examples/docs/slider.md
View file @ b527ca88
......@@ -137,7 +137,7 @@
```
:::
## API
## Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
| min | 最小值 | number | - | 0 |
......
examples/docs/time-picker.md
View file @ b527ca88
......@@ -6,23 +6,18 @@
}
</style>
## 固定时间点
提供几个固定的时间点供用户选择。
<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>
## Time Picker 时间选择器
用于选择或输入日期
### 固定时间点
提供几个固定的时间点供用户选择
:::demo 使用 el-time-select 标签，分别通过`star`、`end`和`step`指定可选的起始时间、结束时间和步长
```html
<el-time-select
v-model="value"
v-model="value1"
:picker-options="{
start: '08:30',
step: '00:15',
......@@ -31,89 +26,29 @@
placeholder="选择时间">
</el-time-select>
```
:::
## 任意时间点
可以选择任意时间。
<div class="demo-box">
<el-time-picker
v-model="value2"
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="value3"
placeholder="任意时间点">
</el-time-picker>
</div>
可以选择任意时间
:::demo 使用 el-time-picker 标签，通过`selectableRange`限制可选时间范围
```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"
v-model="value2"
:picker-options="{
selectableRange: '18:30:00 - 20:30:00'
}"
placeholder="任意时间点">
</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
<el-time-select
placeholder="起始时间"
......@@ -135,72 +70,21 @@
}">
</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
<el-time-picker
is-range
v-model="value"
v-model="value3"
placeholder="选择时间范围">
</el-time-picker>
```
:::
<script>
export default {
......@@ -209,36 +93,32 @@
value1: '',
value2: '',
value3: '',
value4: '',
value5: '',
startTime: '',
endTime: '',
startTime2: '',
endTime2: ''
endTime: ''
};
}
}
</script>
## API
### Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
| value | 绑定值，需双向绑定 | String | | |
| readonly | 只读 | Boolean | | false |
| placeholder | 占位内容 | String | | |
| format | 时间格式化 | String | 小时: `HH`, 分`mm`, 秒`ss` | 'HH:mm:ss' |
| picker-options | 当前时间日期选择器特有的选项，参考下表 | Object | | {} |
| value | 绑定值，需双向绑定 | string | - | - |
| readonly | 只读 | boolean | - | false |
| placeholder | 占位内容 | string | - | - |
| format | 时间格式化 | string | 小时：`HH`，分：`mm`，秒：`ss` | 'HH:mm:ss' |
| picker-options | 当前时间日期选择器特有的选项，参考下表 | object | - | {} |
### time-select Options
### Time Select Options
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---------- |-------------- |---------- |-------------------------------- |-------- |
| start | 开始时间 | String | |09:00 |
| end | 结束时间 | String | |18:00 |
| step | 间隔时间 | String | | 00:30 |
| minTime | 最小时间，小于该时间的时间段将被禁用 | String | | 00:00 |
| start | 开始时间 | string | - | 09:00 |
| end | 结束时间 | string | - | 18:00 |
| step | 间隔时间 | string | - | 00:30 |
| 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 | - | - |
packages/date-picker/src/panel/time-select.vue
View file @ b527ca88
......@@ -105,7 +105,7 @@
if (start && end && step) {
let current = start;
while (compareTime(current, end) === -1) {
while (compareTime(current, end) <= 0) {
result.push({
value: current,
disabled: compareTime(current, this.minTime || '00:00') <= 0
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment