Files
element-plus/website/docs/fr-FR/radio.md
zazzaz f12000f9c2 feat: add website (#135)
* feat: add website

* chore: fix
2020-08-13 15:18:26 +08:00

6.4 KiB

Radio

Boutons de sélection entre plusieurs options.

Usage

Radio ne devrait pas avoir trop d'options. Dans ce cas utilisez plutôt Select.

:::demo Créer un composant Radio est facile, vous avez juste besoin de lier les v-model des options. Chacun équivaut à la valeur de label du radio correspondant. Le type de label est String, Number ou Boolean.

<template>
  <el-radio v-model="radio" label="1">Option A</el-radio>
  <el-radio v-model="radio" label="2">Option B</el-radio>
</template>

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

:::

Désactivé

L'attribut disabled désactive le radio.

:::demo Ajoutez simplement l'attribut disabled au radio.

<template>
  <el-radio disabled v-model="radio" label="disabled">Option A</el-radio>
  <el-radio disabled v-model="radio" label="selected and disabled">Option B</el-radio>
</template>

<script>
  export default {
    data () {
      return {
        radio: 'selected and disabled'
      };
    }
  }
</script>

:::

Groupe de boutons radio

Utile pour choisir entre plusieurs groupes d'options mutuellement exclusives.

:::demo Combinez el-radio-group avec el-radio pour afficher un groupe de radios. Liez une variable au v-model de el-radio-group et configurez le label dans el-radio. Cet élément fournit aussi l'évènement change qui a en paramètre la valeur courante.

<el-radio-group v-model="radio">
  <el-radio :label="3">Option A</el-radio>
  <el-radio :label="6">Option B</el-radio>
  <el-radio :label="9">Option C</el-radio>
</el-radio-group>

<script>
  export default {
    data () {
      return {
        radio: 3
      };
    }
  }
</script>

:::

Style bouton

Des radios affichés comme des boutons standards.

:::demo Changez simplement el-radio pour el-radio-button. L'attribut size permet de régler la taille.

<template>
  <div>
    <el-radio-group v-model="radio1">
      <el-radio-button label="New York"></el-radio-button>
      <el-radio-button label="Washington"></el-radio-button>
      <el-radio-button label="Los Angeles"></el-radio-button>
      <el-radio-button label="Chicago"></el-radio-button>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio2" size="medium">
      <el-radio-button label="New York" ></el-radio-button>
      <el-radio-button label="Washington"></el-radio-button>
      <el-radio-button label="Los Angeles"></el-radio-button>
      <el-radio-button label="Chicago"></el-radio-button>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio3" size="small">
      <el-radio-button label="New York"></el-radio-button>
      <el-radio-button label="Washington" disabled ></el-radio-button>
      <el-radio-button label="Los Angeles"></el-radio-button>
      <el-radio-button label="Chicago"></el-radio-button>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio4" disabled size="mini">
      <el-radio-button label="New York"></el-radio-button>
      <el-radio-button label="Washington"></el-radio-button>
      <el-radio-button label="Los Angeles"></el-radio-button>
      <el-radio-button label="Chicago"></el-radio-button>
    </el-radio-group>
  </div>
</template>

<script>
  export default {
    data () {
      return {
        radio1: 'New York',
        radio2: 'New York',
        radio3: 'New York',
        radio4: 'New York'
      };
    }
  }
</script>

:::

Avec bordures

:::demo L'attribut border ajoute une bordure aux radios.

<template>
  <div>
    <el-radio v-model="radio1" label="1" border>Option A</el-radio>
    <el-radio v-model="radio1" label="2" border>Option B</el-radio>
  </div>
  <div style="margin-top: 20px">
    <el-radio v-model="radio2" label="1" border size="medium">Option A</el-radio>
    <el-radio v-model="radio2" label="2" border size="medium">Option B</el-radio>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio3" size="small">
      <el-radio label="1" border>Option A</el-radio>
      <el-radio label="2" border disabled>Option B</el-radio>
    </el-radio-group>
  </div>
  <div style="margin-top: 20px">
    <el-radio-group v-model="radio4" size="mini" disabled>
      <el-radio label="1" border>Option A</el-radio>
      <el-radio label="2" border>Option B</el-radio>
    </el-radio-group>
  </div>
</template>

<script>
  export default {
    data () {
      return {
        radio1: '1',
        radio2: '1',
        radio3: '1',
        radio4: '1'
      };
    }
  }
</script>

:::

Attributs de Radio

Attribut Description Type Valeurs acceptées Défaut
value / v-model La valeur liée. string / number / boolean — —
label La valeur du radio. string / number / boolean — —
disabled Si le radio est désactivé. boolean — false
border Si une bordure doit être affichée autour du radio. boolean — false
size Taille du radio, ne marche que si border est true. string medium / small / mini —
name Attribut 'name' natif. string — —

Évènements de Radio

Nom Description Paramètres
change Se déclenche quand la valeur change. La valeur du label.

Attributs de Radio-group

Attribut Description Type Valeurs acceptées Défaut
value / v-model La valeur liée. string / number / boolean — —
size Taille des radios. string medium / small / mini —
disabled Si les radios sont désactivés. boolean — false
text-color Couleur du texte quand le bouton est actif. string — #ffffff
fill Bordure et couleur de fond quand le bouton est actif. string — #409EFF

Évènements de Radio-group

Nom Description Paramètres
change Se déclenche quand la valeur change. La valeur du label.

Attributs Radio-button

Attribut Description Type Valeurs acceptées Défaut
label Valeur du radio. string / number — —
disabled Si le radio est désactivé. boolean — false
name Attribut 'name' natif. string — —