2020-10-04 19:57:49 +08:00
## TimePicker
2020-08-13 15:18:26 +08:00
Use el Time Picker para input de tipo time.
### Selector de tiempo arbitrario
Un tiempo arbitrario puede ser escogido.
2020-12-06 22:49:50 +08:00
:::demo Al usar el tag `el-time-picker` , es posible limitar el rango de tiempo al especificar `disabledHours` `disabledMinutes` `disabledSeconds` . Por defecto, es posible hacer scroll con la rueda del mouse para escoger el tiempo, alternativamente se pueden utilizar las flechas de control cuando el atributo `arrow-control` esté establecido.
2020-08-13 15:18:26 +08:00
```html
< template >
< el-time-picker
v-model="value1"
2020-12-06 22:49:50 +08:00
:disabled-hours="disabledHours"
:disabled-minutes="disabledMinutes"
:disabled-seconds="disabledSeconds"
2020-08-13 15:18:26 +08:00
placeholder="Arbitrary time">
< / el-time-picker >
< el-time-picker
arrow-control
v-model="value2"
2020-12-06 22:49:50 +08:00
:disabled-hours="disabledHours"
:disabled-minutes="disabledMinutes"
:disabled-seconds="disabledSeconds"
2020-08-13 15:18:26 +08:00
placeholder="Arbitrary time">
< / el-time-picker >
< / template >
< script >
2020-12-06 22:49:50 +08:00
const makeRange = (start, end) => {
const result = []
for (let i = start; i < = end; i++) {
result.push(i)
}
return result
}
2020-08-13 15:18:26 +08:00
export default {
data() {
return {
value1: new Date(2016, 9, 10, 18, 40),
value2: new Date(2016, 9, 10, 18, 40)
};
2020-12-06 22:49:50 +08:00
},
methods: {
// e.g. allow 17:30:00 - 18:30:00
disabledHours() {
return makeRange(0, 16).concat(makeRange(19, 23))
},
disabledMinutes (hour) {
if (hour === 17) {
return makeRange(0, 29)
}
if (hour === 18) {
return makeRange(31, 59)
}
},
disabledSeconds(hour, minute) {
if (hour === 18 & & minute === 30) {
return makeRange(1, 59)
}
},
},
2020-08-13 15:18:26 +08:00
}
< / script >
```
:::
### Rango de tiempo arbitrario
Es posible escoger un rango de tiempo arbitrario.
:::demo Es posible seleccionar un rango de tiempo al añadir el atributo `is-range` . También, `arrow-control` es soportado en modo de rango.
```html
< template >
< el-time-picker
is-range
v-model="value1"
range-separator="To"
start-placeholder="Start time"
end-placeholder="End time">
< / el-time-picker >
< el-time-picker
is-range
arrow-control
v-model="value2"
range-separator="To"
start-placeholder="Start time"
end-placeholder="End time">
< / el-time-picker >
< / template >
< script >
export default {
data() {
return {
value1: [new Date(2016, 9, 10, 8, 40), new Date(2016, 9, 10, 9, 40)],
value2: [new Date(2016, 9, 10, 8, 40), new Date(2016, 9, 10, 9, 40)]
};
}
}
< / script >
```
:::
### Atributos
| Atributo | Descripción | Tipo | Valores aceptados | Por defecto |
| ----------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | -------------------- |
2020-12-16 22:09:48 +08:00
| value / v-model | valor enlazado | Date | - | - |
2020-08-13 15:18:26 +08:00
| readonly | si el Time Picker está en modo de sólo lectura | boolean | — | false |
| disabled | si el Time Picker se encuentra deshabilitado | boolean | — | false |
| editable | si el input puede ser editado | boolean | — | true |
| clearable | si mostrar el botón de borrado | boolean | — | true |
| size | tamaño del input | string | medium / small / mini | — |
| placeholder | placeholder en un modo fuera de rango | string | — | — |
| start-placeholder | placeholder para el tiempo de inicio en modo de rango | string | — | — |
| end-placeholder | placeholder para el tiempo de finalización en modo de rango | string | — | — |
2020-12-23 15:56:44 +08:00
| is-range | si es posible escoger un rango de tiempo, solo funciona con | boolean | — | false |
| arrow-control | si es posible escoger el tiempo usando los botones de flecha | boolean | — | false |
2020-08-13 15:18:26 +08:00
| align | alineación | left / center / right | left | |
| popper-class | nombre de clase personalizada para el dropdown del Time Picker | string | — | — |
| range-separator | separador de rango | string | - | '-' |
2021-04-08 16:06:14 +08:00
| format | format of the displayed value in the input box | string | see [date formats ](#/en-US/component/date-picker#date-formats ) | HH:mm:ss |
2020-08-13 15:18:26 +08:00
| default-value | opcional, fecha por defecto del calendario | Fecha para Selector de Tiempo, string para el Seleccionador de Tiempo | cualquier cosa aceptada por `new Date()` para el Selector de Tiempo, Selector de Tiempo, valor seleccionable para el Seleccionador de Tiempo | — |
| name | como `name` en input nativo | string | — | — |
| prefix-icon | Clase personalizada para el icono de prefijado | string | — | el-icon-time |
| clear-icon | Clase personalizada para el icono `clear` | string | — | el-icon-circle-close |
2020-12-06 22:49:50 +08:00
| disabledHours | To specify the array of hours that cannot be selected | function | — | - |
| disabledMinutes | To specify the array of minutes that cannot be selected | function(selectedHour) | — | - |
| disabledSeconds | To specify the array of seconds that cannot be selected | function(selectedHour, selectedMinute) | — | - |
2020-08-13 15:18:26 +08:00
### Eventos
| Nombre de Evento | Descripción | Parámetros |
| ---------------- | ---------------------------------------- | ------------------------------ |
| change | se lanza cuando el usuario confirma el valor | valor vinculado del componente |
| blur | se lanza cuando el input se difumina | instancia del componente |
| focus | se lanza cuando el input se enfoca | instancia del componente |
### Metodos
| Metodo | Descripción | Parameteros |
| ------ | -------------------------- | ----------- |
| focus | coloca el foco en el input | — |