element-plus/website/docs/fr-FR/time-select.md
Enguerrand des Vaux b5ed49ae93
feat/TimeSelect (#329)
* feat(time-select): start of migration

* feat(time-select): fix typo

* feat(time-select): minor change

* feat(time-select): working Vue.js 2 time-select

* feat(time-select): migration to v3

* feat(time-select): add select element

* feat(time-select): migrate v-model

* feat(time-select): add type definition

* feat(time-select): add default value for minTime

* feat(time-select): fix documentation

* feat(time-select): export select to use it

* feat(time-select): fix form

* feat(time-select): export time-select to see it in the website

* feat(time-select): fix updateOptions methods

* fix(popper): re-create popper if destroyed when updating

* fix(select): fix options query event

* fix(select): fix checkDefaultFirstOption function

* feat(time-select): add update:modelValue to emit function

* fix(select): better naming

* feat(time-select): deprecated defautl value

* feat(select): support clear icon

* feat(select): add clear-icon documetnation
2020-10-04 19:57:49 +08:00

3.4 KiB

TimeSelect

Utiliser TimeSelect pour sélectionner un horaire.

Sélection d'horaire fixe

Vous pouvez fournir une liste d'horaires fixés pour que l'utilisateur en choisisse un.

:::demo Utilisez el-time-select puis assignez un horaire de début, de fin et un pas grâce aux propriétés start, end et step de l'attribut picker-options.

<el-time-select
  v-model="value"
  :picker-options="{
    start: '08:30',
    step: '00:15',
    end: '18:30'
  }"
  placeholder="Choisissez un horaire">
</el-time-select>

<script>
  export default {
    data() {
      return {
        value: ''
      };
    }
  }
</script>

:::

Intervalle de temps fixe

Vous pouvez définir un intervalle de temps. Si l'horaire de début est sélectionné en premier, certains horaires de fins seront désactivés s'ils ont lieu avant l'horaire de début.

:::demo

<template>
  <el-time-select
    placeholder="Horaire de début"
    v-model="startTime"
    :picker-options="{
      start: '08:30',
      step: '00:15',
      end: '18:30'
    }">
  </el-time-select>
  <el-time-select
    placeholder="Horaire de fin"
    v-model="endTime"
    :picker-options="{
      start: '08:30',
      step: '00:15',
      end: '18:30',
      minTime: startTime
    }">
  </el-time-select>
</template>

<script>
  export default {
    data() {
      return {
        startTime: '',
        endTime: ''
      };
    }
  }
</script>

:::

Attributs

Attribut Description Type Valeurs acceptées Défaut
value / v-model La valeur liée. date(TimePicker) / string(TimeSelect) - -
editable Si le champ d'input est éditable. boolean true
clearable Si un bouton d'effacement doit être affiché. boolean true
size Taille du champ. string medium / small / mini
placeholder Placeholder en mode non-intervalle. string
picker-options Options additionnelles, voir la table ci-dessous. object {}
name Attribut name natif de l'input. string
prefix-icon Classe de l'icône de préfixe. string el-icon-time
clear-icon Classe de l'icône d'effacement. string el-icon-circle-close

Options de TimeSelect

Attribut Description Type Valeurs acceptées Défaut
start Horaire de début. string 09:00
end Horaire de fin. string 18:00
step Intervalle entre les horaires. string 00:30
minTime Horaire minimum, n'importe quel horaire avant celui-ci sera désactivé. string 00:00
maxTime Horaire maximum, n'importe quel horaire après celui-ci sera désactivé. string

Évènements

Nom Description Paramètres
change Se déclenche quand l'utilisateur confirme la valeur. La valeur confirmée.
blur Se déclenche quand le composant perd le focus. L'instance du composant.
focus Se déclenche quand le composant a le focus. L'instance du composant.

Méthodes

Méthode Description Paramètres
focus Met le focus sur le composant. -
blur Enlève le focus sur le composant. -